Correios Web Services API

Name: Correios Web Services API API
Brand: Correios Web Services API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceShipping Logisticsbasic, bearer15 EndpointsREST

For Agents

Look up Brazilian CEP postal codes, quote shipping prices and delivery times, track shipments, and generate pre-postage labels with the Correios Web Services API. Bearer-token authentication obtained via the /token/v1/autentica endpoint.

Quickstart

Get started with Correios Web Services API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"calculate Correios shipping price"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Correios Web Services API API.

Resolve a Brazilian CEP postal code to a structured address with street, neighbourhood, city, and state

Quote national shipping prices for a given service, weight, and origin-destination CEP pair before checkout

Estimate national delivery time by service code and origin-destination CEP for shipping promises on product pages

Track one shipment or a batch of shipments by their tracking codes and stream events to a customer-facing tracking page

GET STARTED

Start building with Correios Web Services API API

Explore with Jentic

View OpenAPI Document

Use for: Get the address details for CEP 01310-100, Calculate the shipping price from São Paulo to Rio de Janeiro for a 2 kg parcel, Estimate delivery time for a SEDEX shipment between two CEPs, Track a Correios shipment by its tracking code

Not supported: Does not handle international courier services, customs clearance, or multi-carrier comparison — use for Brazilian Correios postal pricing, tracking, and pre-postage only.

Jentic publishes the only available OpenAPI document for Correios Web Services API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Correios Web Services API, keeping it validated and agent-ready. The Correios Web Services API integrates Brazil's national postal service into e-commerce and logistics workflows, exposing 15 endpoints for CEP postal-code lookup, shipping price and delivery time calculation, shipment tracking, and pre-postage label generation. Authentication uses a two-step flow: Basic auth against the token endpoint to obtain a bearer token, then bearer auth on the business endpoints. Service is split into Production (cws.correios.com.br) and Homologation environments for testing.

Use Cases

Patterns agents use Correios Web Services API API for, with concrete tasks.

★ Checkout Shipping Quote and ETA

When a Brazilian shopper enters their CEP at checkout, the storefront calls the Correios price and delivery time endpoints to quote freight cost and a delivery promise. CEP lookup pre-fills the address fields, the price endpoint returns the freight, and the delivery time endpoint produces the days-in-transit string shown next to the price.

On CEP entry call GET /cep/v2/enderecos/{cep}, then POST /preco/v1/nacional and POST /prazo/v1/nacional with the cart's weight and dimensions to render quote plus ETA at checkout.

Customer-Facing Shipment Tracking

Power a self-serve tracking page where customers enter a tracking code and see a timeline of Correios scan events. The bulk-tracking endpoint also lets the merchant pre-fetch tracking for every open order on a daily schedule and notify customers of status changes.

On the tracking page call GET /rastro/v1/objetos/{codigoObjeto}, render the events; on a daily cron call GET /rastro/v1/objetos with a list of open orders to detect status changes.

Warehouse Pre-Postage Workflow

Operations teams batch-create pre-postages overnight so the next morning's pickup is ready to go: each order is registered through the pre-postage endpoint, the printable label is fetched, and any cancelled order is removed before the carrier arrives. This keeps the warehouse and Correios in sync without manual portal entry.

For each order call POST /prepostagem/v1/prepostagens, store the returned idPrePostagem, fetch GET /prepostagem/v1/prepostagens/{idPrePostagem}/rotulo to print the label, and DELETE /prepostagem/v1/prepostagens/{idPrePostagem} for any cancellation.

AI Agent Brazil Shipping Assistant via Jentic

An agent answers shopper or merchant questions like 'how much will it cost to send this 1.5 kg box from CEP 04567-001 to 88000-000 by SEDEX?' by searching Jentic for the Correios price operation, calling it with the right inputs, and returning the rate plus delivery time in plain language. The agent never needs to read Correios documentation.

Search Jentic for 'calculate Correios shipping price', load POST /preco/v1/nacional, execute it with the requested weight and CEPs, then call POST /prazo/v1/nacional and combine the results into one answer.

Key Endpoints

15 endpoints — jentic publishes the only available openapi specification for correios web services api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/token/v1/autentica

Exchange Basic credentials for a bearer token

GET

/cep/v2/enderecos/{cep}

Look up an address by Brazilian postal code

POST

/preco/v1/nacional

Calculate national shipping price

POST

/prazo/v1/nacional

Calculate national delivery time

GET

/rastro/v1/objetos/{codigoObjeto}

Track a single shipment

POST

/prepostagem/v1/prepostagens

Create a pre-postage

GET

/prepostagem/v1/prepostagens/{idPrePostagem}/rotulo

Download the printable shipping label

POST

/token/v1/autentica

Exchange Basic credentials for a bearer token

GET

/cep/v2/enderecos/{cep}

Look up an address by Brazilian postal code

POST

/preco/v1/nacional

Calculate national shipping price

POST

/prazo/v1/nacional

Calculate national delivery time

GET

/rastro/v1/objetos/{codigoObjeto}

Track a single shipment

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Correios username/CNPJ and access code are stored encrypted in the Jentic vault (MAXsystem). Jentic exchanges them for a bearer token on demand and rotates the token transparently — neither secret enters the agent's prompt context.

Intent-based discovery

Agents search by intent (e.g., 'calculate Correios shipping price' or 'track Correios shipment') and Jentic returns the matching operation with input and response schemas, so the agent calls the right endpoint without reading Portuguese documentation.

Time to first call

Direct Correios integration: 3-5 days for token flow, environment switching between production and homologation, and pre-postage error handling. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

FedEx API

Global courier API covering rating, shipping, and tracking outside Brazil's domestic postal network.

Choose FedEx when the shipment is international or premium-tier; use Correios for cost-sensitive domestic Brazilian shipping.

Alternative

DHL Shipment Tracking Unified API

DHL's unified tracking API for international shipments handed off from local carriers.

Use DHL when tracking cross-border shipments; Correios is the right choice when the entire journey is inside Brazil.

Complementary

AfterShip API

Multi-carrier tracking aggregator that can normalise Correios events alongside other carriers.

Pair with Correios when a merchant ships via multiple carriers and wants a single tracking timeline per order.

FAQs

Specific to using Correios Web Services API API through Jentic.

Why is there no official OpenAPI spec for Correios Web Services API?

Correios does not publish a single OpenAPI specification covering all of its web services. Jentic generates and maintains this spec so that AI agents and developers can call Correios Web Services API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Correios Web Services API use?

The API uses a two-step flow. Call POST /token/v1/autentica with HTTP Basic auth (username or CNPJ plus access code) to receive a bearer token, then send that token in the Authorization: Bearer header on every business endpoint. Through Jentic, both credentials are stored encrypted and the bearer token is refreshed automatically.

Can I look up a Brazilian address by CEP with this API?

Yes. GET /cep/v2/enderecos/{cep} returns the structured address — street, neighbourhood, city, and state — for a given CEP, which is the canonical primitive for any Brazilian shipping or address-validation flow.

How do I track multiple shipments in one call?

Use GET /rastro/v1/objetos with a list of tracking codes as query parameters. This is the recommended path for daily batch jobs that refresh tracking status for every open order rather than calling the single-object endpoint repeatedly.

What are the rate limits for the Correios Web Services API?

The OpenAPI spec does not declare numeric rate limits. Treat HTTP 429 responses as authoritative, back off using the Retry-After header where present, and confirm contract-specific limits with Correios before high-volume jobs.

How do I generate a shipping label through Jentic?

Search Jentic for 'create Correios pre-postage', execute POST /prepostagem/v1/prepostagens with the parcel and recipient details, then load and execute GET /prepostagem/v1/prepostagens/{idPrePostagem}/rotulo to fetch the printable label.