Back to TideIQGet API Key

API Documentation

Complete guide to integrating TideIQ's contractor eligibility verification API into your applications

Fast Response
~200ms

Average API response time

Reliable
99.9%

Uptime SLA guarantee

Real-time
Live

SAM.gov data integration

Quick Start
Get started with your first API call in minutes
1
Get your API key
2
Make your first request
3
Parse the response
curl -X POST "https://api.tideiq.io/v1/eligibility/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": {
      "uei": "ZQGGHJH74DM7"
    },
    "naics": "541511",
    "size_basis": {
      "kind": "receipts",
      "value": 25000000
    }
  }'
API Endpoints
Complete list of available endpoints and their functionality
POST/v1/eligibility/checkSingle contractor eligibility verification
Core
POST/v1/eligibility/bulkBulk contractor eligibility verification
Pro+
GET/v1/jobs/{id}Check bulk job status and results
Pro+
GET/v1/naics/{code}/sizeGet SBA size standards for NAICS code
Core
Response Format
Standard response structure for eligibility verification
{
  "eligible": true,
  "request_id": "req_abc123",
  "checked_at": "2024-01-15T10:30:00Z",
  "summary": "No exclusions; active SAM; size SMALL",
  "sam": {
    "uei": "ZQGGHJH74DM7",
    "cage": "8PRW9", 
    "active": true,
    "exclusions": {
      "count": 0,
      "active": []
    }
  },
  "size": {
    "status": "small",
    "threshold": 34500000,
    "basis": "receipts",
    "naics": "541511"
  },
  "evidence": [
    {
      "source": "SAM_ENTITY",
      "retrieved_at": "2024-01-15T10:30:00Z",
      "url": "https://api.sam.gov/entity/..."
    }
  ]
}
Error Handling
Standard error codes and troubleshooting guide

HTTP Status Codes

200Success
400Bad Request
401Unauthorized
429Rate Limited
500Server Error

Error Response

{
  "error": {
    "code": "INVALID_NAICS",
    "message": "Invalid NAICS code format",
    "details": "NAICS must be 6 digits"
  },
  "request_id": "req_abc123"
}

Ready to get started?

Create your free account and get your API key in less than 2 minutes

Get Started FreeContact Support