Skip to main content

Fetch by id

GET/applications/by-id

Fetch applications by id

Fetch up to 30 of your institution's applications by id. Ids that don't exist — or don't belong to your institution — are silently dropped from the response.
Try it
Stored only in your browser (localStorage).
Query parameters
Comma-separated submission ids (max 30).
See "Field selection".

Parameters

NameInTypeDescription
idsrequiredquerystringComma-separated submission ids (max 30).
formatquerystring
fieldsquerystringSee "Field selection".

Example response

{
  "code": 200,
  "requested_count": 3,
  "found_count": 2,
  "data": [
    {
      "id": "9f2abc",
      "personal": {
        "first_name": "Ada",
        "last_name": "Obi",
        "email": "ada@example.com"
      },
      "application": {
        "program_name": "BSc Engineering",
        "cycle_name": "2026 Intake",
        "stage": "submitted",
        "decision": "none"
      },
      "payment": {
        "paid": true,
        "amount": 50
      }
    }
  ]
}
curl -X GET 'https://api.uapply.africa/api/v1/applications/by-id?ids=sandbox-app-001%2Csandbox-app-002' \
-H 'Authorization: Bearer YOUR_KEY'

Notes​

  • requested_count is what you asked for; found_count is what was returned.
  • Use this when you already know the ids (e.g. from a webhook or search) and don't need pagination.