API Onboarding for Structured Record Delivery

This documentation describes the preview request flow, sample authentication pattern, schema structure, and export model for agency-oriented B2B data delivery.

Developer Hub Request API Access

Quickstart

Preview onboarding flow

Request access through the Developer Preview intake form.

Receive a sample API key and minimal schema notes by email for integration planning.

Authenticate using the supplied Bearer token in the Authorization header.

Make scoped queries (industry, geography, status) to validate schema and export formats.

Request bulk exports or a 50-row sample for offline validation when ready.

Authentication

Bearer token header

Developer Preview access uses a sample Bearer token pattern. Preview keys are issued manually and are intended for schema review and integration planning.

Header Example

Authorization: Bearer aexo_sample_live_01HZZ9Q7WF3N4APIEXAMPLE

cURL example

curl -s -H "Authorization: Bearer aexo_sample_live_01HZZ9Q7WF3N4APIEXAMPLE"   "https://api.aexo.online/v1/records?industry=trucking&state=IL&status=active&limit=10"

The Developer Preview uses manually issued keys in a recognizable sample format (prefix: aexo_sample_). Keys are scoped per account and intended for schema validation and integration testing only.

Schema

Field definitions

The table below lists delivered field names and coverage estimates. Sample responses in this preview include synthetic sample identifiers prefixed with aexo_sample_ to avoid confusion with live keys.

Field Name	Data Type	Description	Coverage %
record_id	string	Stable record identifier for AEXO exports.	100%
business_name	string	Registered or listed business name.	99%
license_number	string	State-issued license or registration number where available.	92%
dot_number	string	USDOT identifier for transport-related records.	44%
owner_contact	string	Publicly available owner or officer contact field.	68%
phone_number	string	Primary phone number normalized to a standard format.	87%
sic_code	string	Industry classification code when present in source records.	76%
status	enum	Operational or licensing status derived from the source registry.	95%
source_registry	string	Official source system or licensing authority name.	100%
updated_at	date	Most recent source refresh date for the delivered record.	100%

Query Example

Example GET request

Example showing a scoped query for transport-related records. This is a static example for integration tests — no live query is executed from this page.

GET /v1/records?industry=trucking&state=IL&status=active&limit=10
Host: api.aexo.online
Authorization: Bearer aexo_sample_live_01HZZ9Q7WF3N4APIEXAMPLE

JavaScript fetch

fetch('https://api.aexo.online/v1/records?industry=trucking&state=IL&status=active&limit=10', {
  headers: { 'Authorization': 'Bearer aexo_sample_live_01HZZ9Q7WF3N4APIEXAMPLE' }
})
.then(r => r.json())
.then(console.log)

Sample Response

Static JSON example

{
  "request_id": "aexo_sample_req_20260516_001",
  "mode": "developer_preview",
  "data": [
    {
      "record_id": "aexo_sample_rec_01482",
      "business_name": "Summit Freight Services LLC",
      "license_number": "MC-443812",
      "dot_number": "2918451",
      "owner_contact": "Jordan Patel",
      "phone_number": "+1-312-555-0183",
      "sic_code": "4213",
      "status": "active",
      "city": "Chicago",
      "state": "IL",
      "source_registry": "Federal Motor Carrier Safety Administration",
      "updated_at": "2026-05-01"
    }
  ]
}

Rate Limits

Preview access tiers

Standard

500 requests/day

Agency

2,000 requests/day

Bulk Exports

File-based delivery

Bulk exports are delivered as CSV or JSON within 24 business hours. Preview delivery is suitable for integration planning, schema review, and controlled agency workflows.

SDKs

Coming Soon

Python and Node.js placeholders

Python SDK stub reserved for search, export, and schema helpers.

Node.js SDK stub reserved for authentication, query building, and export retrieval.

Postman Collection

Coming Soon

Collection placeholder

A Postman collection will be attached to the Developer Preview once the request and export patterns are finalized.

Request Access

Request API Access

Use this form to request Developer Preview access, sample key review, or schema clarification for your integration planning workflow.