Company Information - Peru

Description

Retrieve comprehensive company information from Peru including RUC, business address, contact details, financial data, company size, and economic activity (CIIU).

HTTP method POST

Endpoint

https://lu0lfdczmd.execute-api.us-west-2.amazonaws.com/api/companies

info

This endpoint requires AWS IAM Signature authentication. Contact IT support to get credentials (ACCESS KEY ID, SECRET ACCESS KEY).

• REGION: us-west-2
• SERVICE: execute-api

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Content-Type	✅	string	application/json

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
country	✅	string	PER (Peru)
taxID	✅	object	Tax identification object
taxID.identityNumber	✅	string	RUC number (e.g., "20100057876")
taxID.checkDigit	❌	string	Not applicable for Peru
companyName	❌	string	Company name (required if searchType=2)
searchType	✅	number	1 (by RUC) or 2 (by company name)
authToken	✅	string	Token access for request

Request example

Search by RUC

{
    "country": "PER",
    "taxID": {
        "identityNumber": "20100057876",
        "checkDigit": ""
    },
    "companyName": "",
    "searchType": 1,
    "authToken": "c0444aba-d507-11ea-87d0-0242ac130003"
}

Search by Company Name

{
    "country": "PER",
    "taxID": {
        "identityNumber": "",
        "checkDigit": ""
    },
    "companyName": "Empresa Ejemplo SAC",
    "searchType": 2,
    "authToken": "c0444aba-d507-11ea-87d0-0242ac130003"
}

Status code responses

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

Response 200 status code

{
    "trackingId": "1289580121575923712",
    "data": {
        "result": 1,
        "companyList": [
            {
            "id": 431,
            "ruc": "20100057876",
            "companyName": "FORU PLASTIK S.A",
            "address": "CALLE LOS HILANDEROS 120 URB. URBANIZACION VULCANO",
            "district": "ATE",
            "province": "LIMA",
            "departament": "LIMA",
            "phoneNumber": "3480558",
            "email": "teknopor@foruplastik.com.pe",
            "numberOfEmployees": "39",
            "sales": "62,787.00",
            "companySize": "PEQUEÑA EMPRESA",
            "ciiuCode": "25200",
            "economicActivity": "FAB. DE PRODUCTOS DE PLASTICOS.",
            "dateStablished": "10/09/1992",
            "contactName": "FORT DEL SOLAR GUY BERNARDO",
            "title": "DIRECTOR",
            }
        ]
    }
}

Error codes

Code	Message	Additional Info
E001	Token to do request is missing or invalid	Check authToken parameter
E002	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