List contract rates
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.opereit.ai/v1/contracts/{contract_id}/rates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "<string>",
"contract_id": "<string>",
"origin_country": "<string>",
"destination_country": "<string>",
"service_type": "EXPRESS_WORLDWIDE",
"container_type": "PARCEL",
"weight_mode": "FIXED",
"rate_type": "FLAT",
"rate": "12.50",
"currency": "EUR",
"origin_postcode": "<string>",
"destination_postcode": "<string>",
"weight": "<string>",
"weight_min": "<string>",
"weight_max": "<string>"
}
],
"pagination": {
"cursor": "<string>",
"has_more": true
}
}{
"statusCode": 401,
"statusReasonCode": "AUTHENTICATION_REQUIRED",
"error": "Authentication required"
}{
"statusCode": 404,
"statusReasonCode": "CONTRACT_NOT_FOUND",
"error": "Contract not found"
}Contracts
List contract rates
Returns a cursor-paginated list of rate-card entries extracted from a contract. Each entry represents a single (origin, destination, service, weight) rate.
GET
/
v1
/
contracts
/
{contract_id}
/
rates
List contract rates
const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.opereit.ai/v1/contracts/{contract_id}/rates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "<string>",
"contract_id": "<string>",
"origin_country": "<string>",
"destination_country": "<string>",
"service_type": "EXPRESS_WORLDWIDE",
"container_type": "PARCEL",
"weight_mode": "FIXED",
"rate_type": "FLAT",
"rate": "12.50",
"currency": "EUR",
"origin_postcode": "<string>",
"destination_postcode": "<string>",
"weight": "<string>",
"weight_min": "<string>",
"weight_max": "<string>"
}
],
"pagination": {
"cursor": "<string>",
"has_more": true
}
}{
"statusCode": 401,
"statusReasonCode": "AUTHENTICATION_REQUIRED",
"error": "Authentication required"
}{
"statusCode": 404,
"statusReasonCode": "CONTRACT_NOT_FOUND",
"error": "Contract not found"
}Contracts needs to be activated on your account before you can use it. Reach out to your Opereit account manager to get it turned on.
Authorizations
HTTP Basic Auth using your API key. Send Authorization: Basic base64(key_id:key_secret).
Path Parameters
ID of the contract.
Query Parameters
Number of items to return per request.
Required range:
1 <= x <= 100Opaque cursor from a previous response. Omit on the first request.
Filter by ISO 3166-1 alpha-2 origin country code.
Required string length:
2Filter by ISO 3166-1 alpha-2 destination country code.
Required string length:
2Filter by carrier service code (e.g. EXPRESS_WORLDWIDE).
Return only rates whose weight band overlaps with weight ≥ this value (kg).
Return only rates whose weight band overlaps with weight ≤ this value (kg).
Last modified on August 25, 2026