Get My Rate Cards

Fetch every carrier rate card currently assigned to your account.

/rate-cards/mine

GET https://api.terminal.africa/v1/rate-cards/mine

This endpoint allows you to get every carrier-wide rate card your account currently resolves to, across every carrier and every service direction. Carriers with no card assigned are omitted from cards rather than returned empty.

This endpoint takes no parameters — the result is derived entirely from the authenticated account.

Headers

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

Each entry in cards is a Rate Card with a directions array.

200: OK Rate cards retrieved successfully.

{
    "status": true,
    "message": "Rate cards retrieved successfully",
    "data": {
        "cards": [
            {
                "carrier": "dhl-ng",
                "carrier_name": "DHL Express",
                "pricing_grade": "strategic",
                "updated_at": "2026-09-04T11:22:41.006Z",
                "directions": [
                    {
                        "user_country": "NG",
                        "service_direction": "export",
                        "rate_card_id": "RTC-73920184455",
                        "name": "DHL Export Strategic",
                        "description": "Outbound international from Nigeria",
                        "currency": "NGN",
                        "updated_at": "2026-09-04T11:22:41.006Z",
                        "transit": {
                            "min": 2,
                            "max": 6,
                            "unit": "days",
                            "side": "delivery"
                        }
                    },
                    {
                        "user_country": "NG",
                        "service_direction": "import",
                        "rate_card_id": "RTC-73920184456",
                        "name": "DHL Import Strategic",
                        "description": "",
                        "currency": "NGN",
                        "updated_at": "2026-08-29T08:10:02.551Z",
                        "transit": {
                            "min": 3,
                            "max": 7,
                            "unit": "days",
                            "side": "delivery"
                        }
                    }
                ]
            },
            {
                "carrier": "terminal-express",
                "carrier_name": "Terminal Express",
                "pricing_grade": "standard",
                "updated_at": "2026-08-14T15:03:18.772Z",
                "directions": [
                    {
                        "user_country": "NG",
                        "service_direction": "local",
                        "rate_card_id": "RTC-51028837741",
                        "name": "Terminal Express Local",
                        "description": "Domestic Nigeria",
                        "currency": "NGN",
                        "updated_at": "2026-08-14T15:03:18.772Z",
                        "transit": {
                            "min": 1,
                            "max": 3,
                            "unit": "days",
                            "side": "delivery"
                        }
                    }
                ]
            }
        ]
    }
}