Company Information - Bolivia

Description

Retrieve comprehensive company information from Bolivia including business details, contact information, financial data, and executive information.

HTTP method POST

Endpoint

https://apidev.msla-id.com/experience-companyinfo-api-v1/api/idv-govcheck/v1/company/search

info

This endpoint requires Bearer Token authentication. Contact IT support to get credentials.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Content-Type	✅	string	application/json
Authorization	✅	string	Bearer JWT token

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
country	✅	string	BOL (Bolivia)
taxID	✅	object	Tax identification object
taxID.identityNumber	✅	string	NIT number (e.g., "00137381")
taxID.checkDigit	❌	string	Not applicable for Bolivia
companyName	❌	string	Company name (required if searchType=2)
searchType	✅	number	1 (by tax ID) or 2 (by company name)

Name search format

When using searchType=2, the companyName field only accepts letters (A-Z, a-z, ñ, Ñ), numbers (0-9), and spaces. Accents, punctuation marks, and special characters are not allowed.

Examples:

• ✅ Valid: METAL WORKING AMW, EMPRESA MINERA FARFAN SRL
• ❌ Invalid: METAL-WORKING, EMPRESA S.R.L.

Request example

Search by Tax ID

{
    "country": "BOL",
    "taxID": {
        "identityNumber": "00137381",
        "checkDigit": ""
    },
    "companyName": "",
    "searchType": 1
}

Search by Company Name

{
    "country": "BOL",
    "taxID": {
        "identityNumber": "",
        "checkDigit": ""
    },
    "companyName": "METAL WORKING AMW",
    "searchType": 2
}

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
500	Internal server error

Response 200 status code

{
  "traceId": "4ee16864f0169a5d",
  "timestamp": "2026-05-11 14:13:00",
  "data": {
    "result": 1,
    "companyList": [
      {
        "nit": "00137381",
        "companyStatus": "ACTIVO",
        "seprecRegistrationNumber": "137381",
        "previousRegistrationNumber": "00137381",
        "companyName": "CIRO ANTONIO DIAZ AVILA",
        "economicUnitTypeId": "18",
        "economicUnitTypeName": "EMPRESA UNIPERSONAL",
        "closingMonth": "4",
        "lastUpdateYear": "2024",
        "updateStatusId": "16",
        "updateStatusName": "MATRICULA RENOVADA",
        "socialObject": "IMPORTACION EN GRAL REFERIDO A PRODUCTOS COMOHARINA ARROZ JABON ACEITE TRIGO S OYA COHETILLOS Y PIROTECNICOS",
        "addressId": "85429",
        "addressStreet": "24 DE SEPTIEMBRE",
        "addressNumber": "1000",
        "addressBuilding": null,
        "addressFloor": null,
        "addressLat": "-16.540834",
        "addressLng": "-68.062195",
        "addressDepartmentId": "420",
        "addressDepartmentName": "LA PAZ",
        "addressProvinceId": "438",
        "addressProvinceName": "MURILLO",
        "addressMunicipalityId": "578",
        "addressMunicipalityName": "LA PAZ",
        "addressStreetType": "AVENIDA",
        "phone1": "78888611",
        "phone2": "78888611",
        "phone3": null,
        "email": "vgaconsultores@hotmail.com",
        "website": null,
        "detail_observation": null
      }
    ]
  }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-4005",
    "message": "Bad request - Invalid parameters provided",
    "data": null
}

{
  "traceId": "2f4a73b593ba1e7f",
  "timestamp": "2026-05-13 14:39:15",
  "code": "IDV-1002",
  "message": "Data not found.",
  "data": null
}

{
  "traceId": "a444e2718ea7a5b9",
  "timestamp": "2026-05-13 14:43:08",
  "code": "DOM-3005",
  "message": "Invalid search type. Supported values are: 1 (search by tax ID) or 2 (search by company name).",
  "data": null
}

{
    "traceId": "51ae18b2479f33a1",
    "timestamp": "2026-05-13 15:31:32",
    "code": "DOM-3020",
    "message": "Country not supported.",
    "data": null
}

Response 401 status code

{
    "timestamp": "2025-03-16T11:20:46.000Z",
    "status": 401,
    "error": "Unauthorized",
    "message": "Bearer token is missing or invalid",
    "path": "/api/companies"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}

Error codes

Code	Message	Additional Info
E001	Bearer token is missing or invalid	Check authorization header
E002	Bearer token expired, contact with your administrator	Contact IT support
E101	Field identityNumber is required	Required when searchType=1
E102	Field companyName is required and length > 4 characters	Required when searchType=2
E104	You have exceeded the daily query limit	Limit: 10000 requests/day