Skip to content

Public documentation and OpenAPI specification for the SICCodeAPI

Notifications You must be signed in to change notification settings

SpatialDays/SICCodeAPI-Docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIC Code Lookup API

Fast, reliable access to official UK Standard Industrial Classification (SIC) Codes.

The SIC Code Lookup API returns simple, predictable JSON and is designed for lookup, validation, enrichment, and reporting use cases.


OVERVIEW

The API provides two core capabilities:

  1. Get SIC Description by Code Retrieve the official SIC Description for a given SIC Code.

  2. Search SIC Codes by Description Retrieve SIC Codes whose Descriptions contain a given keyword.

Interactive API documentation (Postman): https://documenter.getpostman.com/view/6869909/2sBXc8oPEn


AUTHENTICATION

  • This API is distributed via RapidAPI
  • To execute requests, you’ll need a free RapidAPI account and API key
  • Create a free account at rapidapi.com.
  • Subscribe to the SICCodeAPI free plan in the RapidAPI API Hub.
  • RapidAPI issues an API key immediately upon subscription.
  • No additional authentication or setup is required.

BASE URL

All requests are made through the RapidAPI gateway.


ENDPOINTS

1. Get SIC Description by Code

Retrieve the official SIC Description for a given SIC Code.

Request: GET /SICCodeAPI/code

Query Parameters:

  • Name: code
  • Type: string
  • Required: Yes
  • Description: SIC code

Example: /SICCodeAPI/code?code=0111

Response (200): { "0111": "Grow cereals & other crops" }


2. Search SIC Codes by Description

Retrieve SIC Codes whose Descriptions contain a given keyword.

Request: GET /SICCodeAPI/description

Query Parameters:

  • Name: description
  • Type: string
  • Required: Yes
  • Description: Search keyword (case-insensitive)

Example: /SICCodeAPI/description?description=fishing

Response (200): { "0501": "Fishing", "03110": "Marine fishing", "03120": "Freshwater fishing" }


RESPONSE FORMAT

All successful responses return a JSON object where:

  • Keys are SIC Codes (strings)
  • Values are official SIC Descriptions

Example { "<sic_code>": "" }


ERRORS

If no matching SIC Code or Description is found, the API may return an empty JSON object or an error response depending on the request.


NOTES

  • All endpoints are read-only
  • No request body is required
  • Results are deterministic and based on official SIC classifications
  • The /SICCodeAPI/description endpoint may return multiple results

PRICING

  • The API is currently available under a free plan with up to 10,000 requests per month
  • No subscription fees
  • No overage charges
  • Requests above the monthly quota are blocked
  • Higher-volume plans may be introduced if demand requires

For higher-volume usage and pricing enquiries: enquiries@spatialdays.com


TYPICAL USE CASES

  • Business classification and validation
  • Data enrichment for company records
  • Compliance and regulatory tooling
  • Analytics and reporting workflows

About

Public documentation and OpenAPI specification for the SICCodeAPI

Topics

Resources

Security policy

Stars

Watchers

Forks