---
title: "Get SME registration status"
method: GET
path: "/api/v1/sme-registration/status"
tags: ["SME Registration"]
---

# Get SME registration status

`GET /api/v1/sme-registration/status`

## Request

- Base URL: `https://sandbox.api.afriex.com`
- URL: `https://sandbox.api.afriex.com/api/v1/sme-registration/status`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/afriex/apis/afriex-business-api/docs/api/v1/sme-registration/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the most recent SME registration status for the authenticated business. Once the registration has been submitted, the response also includes the latest review outcome. Requires the `COMPLIANCE.KYB.READ` key permission.

## Response `200`

Current SME registration status.

- object
  - `data` object
    - `onboardingRequestId` string, nullable: Null when the business has never registered.
    - `status` 'OTP_PENDING' | 'DETAILS_PENDING' | 'SUBMITTED' | 'REJECTED' | 'EXPIRED' | 'null', nullable
    - `reviewStatus` 'SUBMITTED' | 'PROCESSING' | 'APPROVED' | 'REJECTED' | 'CLOSED' | 'UNDER_REVIEW' | 'UNKNOWN': Public review outcome, present only once the registration has been submitted. `APPROVED` means the business's dedicated KES virtual accounts can be issued under its own entity; `UNKNOWN` is a forward-compatibility slot for any provider code Afriex has not mapped yet. The set may grow over time; handle unknown values by falling back to `UNKNOWN`.
    - `rejectReasons` string[], nullable
    - `isReviewStatusStale` boolean: True when Afriex could not reach the provider for a fresh review outcome on this read, so `reviewStatus` reflects the last known value (or `UNKNOWN` if none is cached) rather than the current one. Absent when the read succeeded.

## Other responses

- `401`: Unauthorized - Invalid business API key.
- `500`: Server error.
- `503`: Temporarily unavailable: an upstream service failed or timed out, or the API is momentarily offline. Retry with backoff and honour the Retry-After header when present.

---

[API](https://skmtc.dev/afriex/apis/afriex-business-api.md) - [All operations](https://skmtc.dev/afriex/apis/afriex-business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/afriex/apis/afriex-business-api/revisions/d94198b6c256?raw)