> ## Documentation Index > Fetch the complete documentation index at: https://docs.kirafin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get an ultimate payor > Read one of your ultimate payors with its screening `status`. ## OpenAPI ````yaml /openapi/kira-api.2026-06-01.json get /v1/ultimate-payors/{ultimate_payor_id} openapi: 3.1.0 info: title: Kira API version: '2026-06-01' description: >- REST API for users, KYC/KYB verification, virtual accounts, payouts, recipients, and webhooks. Every request except the token call needs a bearer access token (see Authentication). Pin your account to the recommended version before integrating (see [Versioning](/using-the-api/versioning)). contact: name: Kira API Support email: support@kirafin.ai servers: - url: https://api.balampay.com description: Production - url: https://api.balampay.com/sandbox description: Sandbox security: - bearerAuth: [] tags: - name: Authentication - name: Versioning - name: Users - name: Virtual Accounts - name: Recipients - name: Quotations - name: Payouts - name: Ultimate Payors - name: Capabilities - name: Reference - name: RFIs paths: /v1/ultimate-payors/{ultimate_payor_id}: get: tags: - Ultimate Payors summary: Get an ultimate payor description: Read one of your ultimate payors with its screening `status`. operationId: get_v1-ultimate-payors-ultimate-payor-id parameters: - in: path name: ultimate_payor_id required: true schema: type: string format: uuid description: The `id` the payor was created with. - in: header name: X-Api-Version required: false description: >- Version applied to this request. It wins over your account's pinned version — see [Versioning](/using-the-api/versioning). schema: type: string example: '2026-06-01' responses: '200': description: The payor. content: application/json: schema: $ref: '#/components/schemas/UltimatePayor' example: id: b6f1c1a4-0c57-4a51-9d0f-6d2b3c1e9a10 legal_name: Acme Holdings LLC city: New York country: USA sub_client_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee status: verified created_at: '2026-10-08T12:00:00.000Z' updated_at: '2026-10-08T12:00:00.000Z' '400': description: >- `ultimate_payor_id` is not a UUID. The id is checked before the lookup, so a malformed one is a `400`, never a `404`. `details` calls the parameter `id`. content: application/json: schema: $ref: '#/components/schemas/UltimatePayorErrorResponse' example: error: ValidationError message: 'the request is invalid: 1 field rejected' details: - id must be a UUID '401': description: >- No valid bearer token came with the request. Get one from [Get access token](/api-reference/authentication/get-access-token) and send it as `Authorization: Bearer `. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: invalid_request message: >- The request was not authenticated. Request a token at POST /auth with your Client ID and your API key, then send it as Authorization: Bearer . '404': description: >- No payor of yours has that id. The same body comes back whether the id does not exist or the payor belongs to another client. content: application/json: schema: $ref: '#/components/schemas/UltimatePayorErrorResponse' example: error: NotFoundError message: ultimate payor not found '500': description: >- Something failed on our side. Retry, and if it keeps happening contact your Kira contact with the time of the call. content: application/json: schema: $ref: '#/components/schemas/UltimatePayorErrorResponse' example: error: InternalError message: an unexpected error occurred security: - bearerAuth: [] apiKeyAuth: [] servers: - url: https://api.balampay.com/sandbox description: Sandbox - url: https://api.balampay.com description: Production components: schemas: UltimatePayor: type: object description: >- A business one of your sub-clients pays on behalf of — see [The ultimate payor object](/reference/ultimate-payors/the-ultimate-payor-object). properties: id: type: string format: uuid description: >- The payor's identifier. Send it as `ultimate_payor_id` on a payout made on its behalf. legal_name: type: string description: The payor's legal name. city: type: string description: The city the payor is based in. country: type: string description: The payor's country, as an upper-case ISO 3166-1 alpha-3 code. sub_client_id: type: string format: uuid description: The `user_id` of the sub-client that pays on this payor's behalf. status: type: - string - 'null' description: >- The status of the payor's screening, which decides whether a payout can go out on its behalf — see [Values](/reference/ultimate-payors/values#status). Available options: `verifying`, `verified`, `failed`, `rejected`. `null` when the payor has no screening. created_at: type: string format: date-time description: When the payor was registered, ISO 8601. updated_at: type: string format: date-time description: >- When the payor itself last changed, ISO 8601. A new screening status does not change it. UltimatePayorErrorResponse: type: object properties: error: type: string description: The kind of error. message: type: string description: What went wrong, in one sentence. details: type: array description: One line per rejected value. Only on a `400`. items: type: string ErrorResponse: type: object properties: message: type: string code: type: string statusCode: type: number error: type: string timestamp: type: string path: type: string details: {} required: - message securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- The `data.access_token` value from [Get access token](/api-reference/authentication/get-access-token). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.