Api reference
Get POBO KYB status
GET/api/merchant/pobo/users/{poboUserId}/onboarding
Refreshes and returns the latest KYB state. Poll while response.kyb.status is processing.
Request
Parameters
Prop
Type
Responses
200 POBO business and KYB status
{ "type": "object", "required": [ "message", "response" ], "properties": { "message": { "type": "string" }, "response": { "type": "object", "required": [ "poboUserId", "businessName", "country", "allowNairaCollection", "nairaCollectionStatus", "wallets", "agreement", "kyb", "createdAt", "updatedAt" ], "properties": { "poboUserId": { "type": "string", "example": "pobou_3a2b1c0d4e5f" }, "businessName": { "type": "string" }, "country": { "type": "string" }, "allowNairaCollection": { "type": "boolean" }, "nairaCollectionStatus": { "type": "string", "enum": [ "not_requested", "pending", "active", "failed" ] }, "wallets": { "type": "object", "required": [ "evm", "svm" ], "properties": { "evm": { "type": "object", "required": [ "address" ], "properties": { "address": { "type": "string" } } }, "svm": { "type": "object", "required": [ "address" ], "properties": { "address": { "type": "string" } } } } }, "agreement": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "pending", "accepted" ] }, "url": { "type": "string", "format": "uri", "description": "Returned only on creation or when issuing a fresh link." } } }, "kyb": { "type": "object", "required": [ "status", "pendingRequirements", "lastSyncedAt" ], "properties": { "status": { "type": "string", "enum": [ "agreement_pending", "not_started", "processing", "action_required", "verified", "declined" ] }, "pendingRequirements": { "type": "array", "items": {} }, "lastSyncedAt": { "type": "string", "format": "date-time", "nullable": true } } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "PoboBusiness" } }, "title": "PoboBusinessResponse"}