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",
  "items": [
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.somepresignedURL.com/withDownloadableFile",
        "client_item_type": "ac_mx"
      }
    },
    {
      "type": "generic",
      "options": {
        "file_url": "https://www.somepresignedURL.com/withDownloadableFile",
        "peopleScope": [
          "powers"
        ],
        "client_item_type": "person_id"
      }
    }
  ],
  "metadata": {
    "some": "value"
  },
  "key_people": [
    {
      "names": "John Doe",
      "scope": [
        "powers"
      ]
    }
  ]
}'
{
  "id": "<string>",
  "status": "created"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
country
string

El código del país en formato ISO 3166-1 alfa-2. Actualmente soportado solo para México ('mx').

​
tag
string

Una etiqueta única que identifica la verificación. Se utiliza para consultas posteriores.

​
tax_id
string

El número de identificación fiscal de la empresa.

​
items
object[]

Una lista de ítems o documentos que serán verificados.

​
metadata
object

Información adicional o metadatos asociados a la verificación. Esto puede incluir detalles personalizados que el cliente desee asociar con la verificación.

​
key_people
object[]

Una lista de personas clave asociadas con la empresa que están sujetas a verificación. Esto incluye sus nombres y el alcance de sus poderes.

Response

200 - application/json
Verificación creada exitosamente.
​
id
string

ID de la verificación creada.

​
status
string

Estado actual de la verificación.

Example:

"created"

Was this page helpful?