Home
Home
  1. RPC search
  • Getting started
  • Authentication
  • Webhooks
  • Embeddable widgets
    • Overview
    • Document upload widget
      • Designing an upload flow
  • Guides
    • Verifying a new business
    • Verifying bank accounts
    • Uploading documents
    • Country-specific fields
    • Supported document types
  • API reference
    • Submissions
      • Reports
        • List available report templates
        • Download a report
      • Create new submission
      • Get submission
      • Update submission
      • Update submission status
      • Run a submission pre-flight check
      • Run business verification
      • Get submission checks
      • Delete submission
      • List submissions
    • Documents
      • Public documents API
        • List documents (public)
        • Upload document (public)
        • Get document (public)
        • Delete document (public)
        • Download document file (public)
        • Rerun validations (public)
      • List documents
      • Upload document
      • Get document
      • Delete document
      • Download document file
      • Rerun validations
    • RPC search
      • RPC search
      • Get company with ID
        GET
      • Look up company by RFC
        GET
      • Search companies by name
        GET
      • Download RPC document
        GET
    • Utilities
      • Matcher
        • Run name matching
  1. RPC search

Look up company by RFC

Production
https://api.niva.co/v1
Production
https://api.niva.co/v1
GET
https://api.niva.co/v1
/rpc/companies/lookup
Mexico only. Looks a company up in Mexico's Public Registry of Commerce (Registro Público de Comercio, RPC) by its RFC (Registro Federal de Contribuyentes, the Mexican tax ID).
An uncached lookup runs in the background. The request returns the full profile as soon as it is ready, or 202 Accepted if processing exceeds timeout seconds (default 120); repeat the same request later. When another request is already processing the same RFC, the request may first wait up to another timeout interval to queue its job. Send fast=true when you only need the company name: if the full profile is not ready yet you get a Partial Company Profile from SAT (Servicio de Administración Tributaria, Mexico's tax authority) without waiting for full registry processing.
404 RFC Not Found: SAT has no record of this RFC
404 Company not found in RPC: SAT knows the RFC, but no registry company matches it
422 RFC format is invalid: Not a 12-character company RFC
422 Company is unable to be processed: The registry record cannot be processed automatically; contact support
422 Multiple companies matched in RPC: Several registry companies carry this RFC; call Get company with ID with one of details.company_ids
| 503 | SAT is unavailable; wait the seconds in Retry-After and repeat the request |

Request

Authorization
Add parameter in header
apiKey
Example:
apiKey: ********************
Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.niva.co/v1/rpc/companies/lookup?rfc=ERW991231ER1' \
--header 'Accept-Language: en' \
--header 'apiKey: <api-key>'

Responses

🟢200OK
application/json
Success
Bodyapplication/json

Examples
{
  "id": "mxc_8kQ2mZ7xVt",
  "legal_name": "Innovaciones Tecnológicas de México, S.A. de C.V.",
  "name": "Innovaciones Tecnológicas de México",
  "company_name_partial_match": false,
  "registration_details": {
    "fme": "N-2023012345",
    "status": "Abierto",
    "jurisdiction": "Ciudad de México",
    "duration": "99 años",
    "business_purpose": "Desarrollo y comercialización de software."
  },
  "tax_status": {
    "rfc": "ERW991231ER1",
    "status": "active"
  },
  "documents": [],
  "owners": [
    {
      "entity_type": "person",
      "type": "person",
      "name": "María Fernanda López García",
      "rfc": "LOGM850315AB1",
      "nationality": "MEX",
      "curp": "LOGM850315MDFPRR09",
      "total_value": null,
      "fixed_capital_value": 36000.0,
      "variable_capital_value": 0,
      "date_of_birth": "1985-03-15",
      "shares": [
        {
          "type": "fixed",
          "name": "nominativas comunes",
          "number": 36,
          "price_per_share": null,
          "value": "36000.0"
        }
      ],
      "nationality_country_code": "MX",
      "ownership_percentage": null
    },
    {
      "entity_type": "person",
      "type": "person",
      "name": "Jorge Ramírez Torres",
      "rfc": "RATJ780101XY2",
      "nationality": "MEX",
      "curp": "RATJ780101HDFMRR05",
      "total_value": null,
      "fixed_capital_value": 36000.0,
      "variable_capital_value": 0,
      "date_of_birth": "1978-01-01",
      "shares": [
        {
          "type": "fixed",
          "name": "nominativas comunes",
          "number": 36,
          "price_per_share": null,
          "value": "36000.0"
        }
      ],
      "nationality_country_code": "MX",
      "ownership_percentage": null
    }
  ],
  "legal_representatives": [
    {
      "name": "Jorge Ramírez Torres",
      "rfc": "RATJ780101XY2",
      "nationality": "MEX",
      "curp": "RATJ780101HDFMRR05",
      "date_of_birth": "1978-01-01",
      "entity_type": "person",
      "roles": [
        {
          "title": "Administrador Único",
          "normalized_title": "Administrador Único",
          "appointed": "1999-12-31",
          "removed": null,
          "powers": [
            {
              "type": "litigation",
              "authorization": "individual",
              "max_amount": null,
              "limitations": [],
              "power": "Pleitos y Cobranzas",
              "limitation": null
            }
          ]
        },
        {
          "title": "Administrador Único",
          "normalized_title": "Administrador Único",
          "appointed": "1999-12-31",
          "removed": null,
          "powers": [
            {
              "type": "litigation",
              "authorization": "individual",
              "max_amount": null,
              "limitations": [],
              "power": "Pleitos y Cobranzas",
              "limitation": null
            }
          ]
        }
      ],
      "nationality_country_code": "MX"
    }
  ],
  "entity_type": "Sociedad Anónima de Capital Variable",
  "incorporation_date": "1999-12-31",
  "industry": [
    "Desarrollo de software"
  ]
}
🟢202Accepted
🟠401Unauthorized
🟠404Not Found
🟠422Unprocessable Content
🔴500Internal Server Error
🔴503Service Unavailable
Previous
Get company with ID
Next
Search companies by name