> For the complete documentation index, see [llms.txt](https://docs.africanies.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.africanies.com/shipment-carriers.md).

# Shipment Carriers

## Get shipment carriers.

> This endpoint lists available shipment carriers/methods for the shipment mode in your headers.\
> \
> Carrier options differ by \`X-Shipment-Mode\`:\
> \- \`SFN\` returns SFN carriers that ship from Nigeria\
> \- \`STN\` returns STN carriers that ship to Nigeria\
> \
> Use this endpoint before purchase so you can:\
> \- display available carrier options to your users,\
> \- enforce carrier limits (max weight and dimensions),\
> \- show estimated delivery window (\`min\_delivery\_business\_day\` / \`max\_delivery\_business\_day\`).\
> \
> Most important field:\
> \- \`slug\`: this is the value you must send as \`shipment\_method\_slug\` when purchasing a shipment.

```json
{"openapi":"3.0.3","info":{"title":"AfricanIES - Sandbox API Documentation","version":"1.0.0"},"tags":[{"name":"Shipment Carriers","description":""}],"servers":[{"url":"https://api-sandbox.africaniestest.com"}],"security":[{"default":[]}],"components":{"securitySchemes":{"default":{"type":"apiKey","name":"Authorization","in":"header","description":"Use your base64-encoded public_key:private_key value."}}},"paths":{"/api/v1/shipment/carriers/{id}":{"get":{"summary":"Get shipment carriers.","operationId":"getShipmentCarriers","description":"This endpoint lists available shipment carriers/methods for the shipment mode in your headers.\n\nCarrier options differ by `X-Shipment-Mode`:\n- `SFN` returns SFN carriers that ship from Nigeria\n- `STN` returns STN carriers that ship to Nigeria\n\nUse this endpoint before purchase so you can:\n- display available carrier options to your users,\n- enforce carrier limits (max weight and dimensions),\n- show estimated delivery window (`min_delivery_business_day` / `max_delivery_business_day`).\n\nMost important field:\n- `slug`: this is the value you must send as `shipment_method_slug` when purchasing a shipment.","parameters":[{"in":"header","name":"X-Shipment-Mode","description":"","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"mode":{"type":"string"},"min_weight":{"type":"string"},"max_weight":{"type":"string"},"max_length":{"type":"string"},"max_width":{"type":"string"},"max_height":{"type":"string"},"min_delivery_business_day":{"type":"string"},"max_delivery_business_day":{"type":"string"}}}}}}}}},"500":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status_code":{"type":"integer"},"message":{"type":"string"},"data":{"type":"array"}}}}}}},"tags":["Shipment Carriers"]}}}}
```