Code Lists

This endpoint allows you to retrieve code lists for values used in the API.

GET /us/Company/CodeLists

Returns a dictionary of code lists that can be used to interpret coded values returned by other endpoints and to populate dropdown selectors in user interfaces.

Response Codes

200 OK 401 Unauthorized 429 Too Many Requests

Try in Swagger UI →

Parameters

This endpoint does not require any parameters.

Example Request

GET /us/Company/CodeLists
Ocp-Apim-Subscription-Key: your-api-key

Example Response

{
  "Success": true,
  "Error": null,
  "Result": {
    "CompanyType": [
      {
        "Code": "0",
        "Value": "Unknown Type",
        "Parameters": null
      },
      {
        "Code": "3",
        "Value": "corporation",
        "Parameters": null
      },
      {
        "Code": "12",
        "Value": "partnership of unknown type",
        "Parameters": null
      },
      {
        "Code": "13",
        "Value": "proprietorship",
        "Parameters": null
      }
    ],
    "LocationType": [
      {
        "Code": "0",
        "Value": "single",
        "Parameters": null
      },
      {
        "Code": "1",
        "Value": "parent",
        "Parameters": null
      }
    ]
  }
}

Available Code Lists

Code List	Description
`CompanyType`	List of company type codes and descriptions (corporation, partnership, proprietorship, etc.)
`LocationType`	List of location type codes and descriptions (single, parent, branch, etc.)
`SocialURLType`	List of social URLs type codes and descriptions
`EmployeesAccuracyIndicator`	List of accuracy indicators for employees number
`SalesAccuracyIndicator`	List of accuracy indicators for sales figures
`SubsidiaryIndicator`	List of subsidiary indicators and descriptions
`HierarchyCode`	List of hierarchy codes and descriptions for corporate structure
`LocalActivityCodeType`	List of activity systems

Code List Entry Structure

Each code list entry contains:

Code - The coded value used in API responses
Value - Human-readable description
Parameters - Additional parameters (when applicable)

Tip

Cache the code lists in your application to avoid repeated API calls. Code lists change infrequently.

Related Endpoint

For activity codes (SIC, NACE, Local Activity), use the Activity Codes endpoint.