Skip to main content
GET
/
api
/
v1
/
kycRequirements
Retrieve KYC Requirements
curl --request GET \
  --url https://skala-sandbox.ripio.com/api/v1/kycRequirements/ \
  --header 'Authorization: Bearer <token>'
{
  "kycRequiredFields": [
    {
      "fieldName": "legalFirstName",
      "required": true,
      "type": "TEXT"
    },
    {
      "fieldName": "legalLastName",
      "required": true,
      "type": "TEXT"
    },
    {
      "fieldName": "dateOfBirth",
      "required": true,
      "type": "DATE"
    },
    {
      "fieldName": "idNumber",
      "required": true,
      "type": "TEXT"
    },
    {
      "fieldName": "nationality",
      "required": true,
      "type": "TEXT",
      "choices": [
        {
          "value": "AR",
          "label": "Argentina"
        },
        {
          "value": "BR",
          "label": "Brazil"
        },
        {
          "value": "CO",
          "label": "Colombia"
        }
      ]
    }
  ]
}
KYC requirements are determined by the country your account is configured for. If your account operates in Argentina, the fields and document types returned will correspond to Argentine regulations. You do not need to filter by country — the response is already scoped to your account’s country.

Authorizations

​
Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Response

Successfully retrieved KYC requirements.

​
kycRequiredFields
object[]
required