POST
/
verifications
curl --request POST \
  --url https://api.gotrebol.com/verifications \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "country": "mx",
  "tag": "etiqueta",
  "flow_id": "some-flow-id",
  "metadata": {
    "some": "value"
  },
  "key_people": [
    {
      "names": "John Doe",
      "scope": [
        "powers"
      ]
    }
  ]
}'
{
  "id": "c8dc41fc-c477-404e-aff7-b9074f86d6d1",
  "status": "pending",
  "account_id": "99999999-9999-9999-9999-999999999999",
  "created_at": "2025-04-28T20:10:06.840Z",
  "updated_at": "2025-04-28T20:10:06.840Z",
  "flow_id": "documents-v2",
  "documents_status": "pending_upload",
  "onboarding_url": "https://onboarding.gotrebol.com/verification/c8dc41fc-c477-404e-aff7-b9074f86d6d1/docs-v2?accessToken=accesstokenid32432434country=mx&client=99999999-9999-9999-9999-999999999999",
  "details_url": "https://app.gotrebol.com/verifications/c8dc41fc-c477-404e-aff7-b9074f86d6d1",
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "items": [
    {
      "id": 25440,
      "item_status": "pending",
      "item_type": "ubos",
      "item_internal_status": "pending_validation",
      "item_value": {},
      "validation_result": {},
      "item_scope": "basic",
      "item_options": {
        "is_optional": true
      }
    }
  ],
  "tag": "33332-34-22",
  "email": "[email protected]",
  "country": "mx",
  "tax_id": "SAG160927GIA",
  "business_name": "Trebol OPCO SAS",
  "options": {},
  "created_by": "99999999-9999-9999-9999-999999999999",
  "onboarding_terms_and_conditions": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Hay dos formas de crear una verificacion, usando un flujo predefinido, el cual ya contiene todos los items y configuraciones necesarias o bien pasando un array de items a verificar, la cual permite crear una verificacion con items personalizados, sin un flujo predefinido.

The body is of type object.

Response

200 - application/json

Verificación creada exitosamente.

The response is of type object.