For the complete documentation index, see llms.txt. This page is also available as Markdown.

Chile COW

Allows you to verify the validity and status of Chilean identity cards by integrating with the system COW (Certificate of Validity) of the Civil Registry of Chile.

Endpoint

POST /civil-registry/vigencia-cow

Authentication

Type
Location
Name

API Key

Header

x-api-key

Request body

Content-Type: application/json

Parameters

Parameter
Type
Required
Description

RUN

string

Yes

Chilean user identification number, including the check digit.

credentialNumber

string

Yes

Unique credential number associated with the identification.

Request example

curl --location '{IDENTITY_API_BASE_URL}/civil-registry/vigencia-cow' \
--header 'x-api-key: {API_KEY}' \
--data-raw '{
  "RUN": "12345678-9",
  "credentialNumber": "000000000"
}'

Responses

200 Success

Response parameters

Parameter
Type
Required
Description

responseData

object

Yes

Contains transaction data.

identity

array

Yes

Contains identity details.

Response parameters — responseData

Parameter
Type
Required
Description

idTransaction

string

Yes

Unique transaction identifier.

transactionDate

string

Yes

Transaction date in format YYYY-MM-DD.

statusTransaction

string

Yes

Transaction status. Possible values: 000 (ACK), 201 (Technical error), 206 (Invalid format), 301 (Non-existent data), 304 (Poor quality), 306 (No fingerprint provided)

errorDescription

string

Yes

Description of the transaction status. Possible values: ACK, Technical error, Invalid format, Non-existent data, Poor quality, No fingerprint provided

Response parameters — identity

Parameter
Type
Required
Description

RUN

string

Yes

Chilean national identification number (RUT).

credentialProfileId

string

Yes

Credential type. Possible values: CEDULA, CEDULA_EXT, Passport, DOC_VIAJE, TITULO_VIAJE, SALVO_CONDUCTO

credentialNumber

string

Yes

Document number associated with the credential.

expiryDate

string

Yes

Credential expiration date.

validityStatus

string

Yes

Credential validity status. Possible values: VALID, NOT VALID

status

string

Yes

Detailed credential status. Possible values: NOT BLOCKED, CREATION/RENEWAL, TEMPORARY, TEMPORARY PERMANENT, DEFINITIVE

Response example

400 Bad Request

401 Unauthorized

403 Forbidden

502 Bad Gateway

504 Gateway Timeout

Last updated