API Documentation

Complete reference for the Procurement Code Finder API

Introduction

The Procurement Code Finder API allows you to classify tender descriptions into procurement codes across multiple classification systems: CPV, PSC, UNSPSC, and NAICS.

All API requests are made to: https://dev.procurementcodefinder.com/api

Authentication

Authenticate your API requests using your API key in the request header: 

X-API-Key: your_api_key_here

You can find your API key in your dashboard after signing up.

Rate Limits

Rate limits vary based on authentication:

  • Demo (no auth): 10 requests per hour
  • Authenticated: 100 requests per minute

CPV Match

Match tender descriptions to Common Procurement Vocabulary (CPV) codes.

Endpoint

POST /api/cpv/match

Request Body

{
  "description": "Supply and installation of solar panels"
}

Response

{
  "success": true,
  "message": "API call successful",
  "data": [
    {
      "code": "09331000",
      "title": "Solar panels",
      "confidence": 0.95,
      "codeType": "cpv",
      "cost": 0.00007
    }
  ],
  "metadata": {
    "costBreakdown": {
      "apiCost": 0.00007,
      "markupPercentage": 50,
      "markupAmount": 0.000035,
      "finalCost": 0.000105,
      "currency": "USD"
    }
  }
}

PSC Match

Match tender descriptions to Product Service Codes (PSC).

Endpoint

POST /api/psc/match

Request Body

{
  "description": "IT consulting and software development services"
}

Response

Same structure as CPV Match response.

UNSPSC Match

Match tender descriptions to United Nations Standard Products and Services Code (UNSPSC).

Endpoint

POST /api/unspsc/match

Request Body

{
  "description": "Office furniture and equipment"
}

Response

Same structure as CPV Match response.

NAICS Match

Match tender descriptions to North American Industry Classification System (NAICS) codes.

Endpoint

POST /api/naics/match

Request Body

{
  "description": "Construction and building services"
}

Response

Same structure as CPV Match response.

Error Codes

The API uses standard HTTP status codes and returns errors in this format:

{
  "success": false,
  "error": "ERROR_TYPE",
  "message": "Human-readable error message"
}

Common Error Types

  • VALIDATION_ERROR - Invalid request parameters
  • UNAUTHORIZED - Missing or invalid API key
  • RATE_LIMIT_EXCEEDED - Too many requests
  • INSUFFICIENT_BALANCE - Not enough USD balance
  • INTERNAL_ERROR - Server error

Pricing

Pricing is dynamic and based on the complexity of the API response. Each response includes a cost breakdown in the metadata.

Typical costs range from $0.00007 to $0.00015 per API call.

All new accounts receive $5.00 USD free balance to get started.