List Regulatory Documents

Fetch the catalog of available regulatory document types, pricing, and HS code rules.

/regulatory-documents

GET https://api.terminal.africa/v1/regulatory-documents

Returns active regulatory documents from the Terminal catalog. Use this to show document names, slugs, sample templates, and base pricing before analyze.

Query Parameters

Name	Type	Description
page	Number	Page number. Defaults to 1.
perPage	Number	Records per page. Defaults to 100. Maximum 100.
carrier	String	Filter by carrier slug or carrier id. e.g. fedex, dhl-ng, CRR-xxxxx.
country	String	Filter by destination country ISO code. e.g. US. Includes wildcard documents.
active	String	true (default), false, or all.

Headers

Name	Type	Description
Authorization*	String	Set value to Bearer SECRET_KEY
Content-Type*	String	Set value to application/json

200: OK Regulatory documents retrieved successfully

{
    "status": true,
    "message": "Regulatory documents retrieved successfully",
    "data": {
        "regulatory_documents": [
            {
                "regulatory_document_id": "RD-ABC123XYZ4567890",
                "name": "FDA Prior Notice",
                "description": "Required for food shipments to the United States",
                "slug": "FDA",
                "logo": "https://cdn.terminal.africa/regulatory/fda.png",
                "sample_document": "https://cdn.terminal.africa/samples/fda-sample.pdf",
                "template": "",
                "carrier_slugs": ["fedex", "dhl-ng", "ups"],
                "cost": 0,
                "currency": "NGN",
                "invoice_cost": 2500,
                "invoice_currency": "NGN",
                "automated": true,
                "active": true,
                "required_countries": ["US"],
                "hs_codes": ["0901", "2106"],
                "created_at": "2026-01-15T10:00:00.000Z",
                "updated_at": "2026-03-01T08:30:00.000Z"
            }
        ],
        "pagination": {
            "page": 1,
            "perPage": 100,
            "total": 12,
            "pageCount": 1,
            "hasNextPage": false,
            "hasPrevPage": false
        }
    }
}