Skip to main content

Consulta de nombre por NIT

Endpoint

  • Método: GET
  • Ruta: /api/ubl2.1/name-by-nit/89008003
  • URL ejemplo: {{BASE_URL}}/api/ubl2.1/name-by-nit/89008003

Consulta de nombre por NIT

Este endpoint permite obtener el nombre y la estructura básica del nombre de una empresa/persona a partir de su NIT (Número de Identificación Tributaria).

URL:
GET /api/ubl2.1/name-by-nit/{nit}

  • nit: Número de identificación tributaria de la empresa o persona.

Autenticación:
Requiere token de autorización en el header:
Authorization: Bearer {API_TOKEN}

Parámetros:

  • En la URL:

  • nit: NIT de la empresa/persona a consultar.

Respuesta:

  • Si encuentra el NIT, retorna la estructura del nombre (primer nombre, otros nombres, primer apellido, segundo apellido).

  • Si no lo encuentra, retorna un mensaje de error.

Autenticación

  • Tipo: Bearer Token
  • Header: Authorization: Bearer {{API_TOKEN}}

Headers

KeyValue
Content-Typeapplication/json
cache-controlno-cache
Connectionkeep-alive
Accept-Encodinggzip, deflate
acceptapplication/json
X-CSRF-TOKEN``

Body

cURL

curl -X GET "{{BASE_URL}}/api/ubl2.1/name-by-nit/89008003" \
-H "Authorization: Bearer {{API_TOKEN}}" \
-H "Content-Type: application/json" \
-H "cache-control: no-cache" \
-H "Connection: keep-alive" \
-H "Accept-Encoding: gzip, deflate" \
-H "accept: application/json" \
-H "X-CSRF-TOKEN: "

Probar endpoint

GET
Consultar nombre por NIT
BASE URL
Se guarda localmente en tu navegador.
BEARER TOKEN
Se guarda solo en esta sesión/pestaña.
PATH PARAMS
NIT
URL FINAL
/api/ubl2.1/name-by-nit/89008003
BODY JSON
RESPUESTA
Envía la solicitud para ver la respuesta aquí.