🚨 Aviso Importante

📢 Encerramento Definitivo da API de Rastreamento - Link&Track

Atenção: A API de Rastreamento de Encomendas dos Correios - Link&Track foi descontinuada de forma definitiva.

Apesar dos esforços para corrigir as instabilidades e inconsistências nas respostas da API oficial dos Correios, não foi possível garantir a confiabilidade necessária para manter o serviço ativo. Por esse motivo, optamos pelo encerramento definitivo do projeto.

Agradecemos imensamente a todos os usuários que confiaram e utilizaram a API ao longo do tempo.

✅ Alternativa Recomendada

Para quem precisa continuar realizando o rastreamento de encomendas dos Correios via API, recomendamos o serviço oferecido pelo SiteRastreio.com, que oferece:

1000 requisições gratuitas por mês
Planos pagos para quem ultrapassar esse limite
API REST estável, atualizada e de fácil integração

👉 Saiba mais em: https://www.siterastreio.com.br/api-correios

👉 Ou entre em contato pelo email contato@wonca.com.br

📌 Histórico da Interrupção

Em meados de março de 2025, identificamos um problema que causava o retorno de eventos incorretos, afetando algumas encomendas de forma intermitente. Por esse motivo, o serviço foi pausado temporariamente enquanto buscávamos uma solução definitiva. Infelizmente, devido à persistência das inconsistências, a decisão pelo encerramento definitivo se fez necessária.

API de Rastreamento de Encomendas dos Correios - Link&Track

Serviço REST que retorna o JSON com os eventos de rastreamento de encomendas dos correios.

COMO USAR

HTTP GET

GET https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR

CLIENTE NODEJS

https://github.com/Diaszano/linketrackjs -> Cliente não oficial criado pelo @diaszano

NODEJS - HTTP NATIVE

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'GET',
  'hostname': 'api.linketrack.com',
  'path': '/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR',
  'headers': {
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

req.end();

NODEJS - USANDO REQUEST

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR',
  'headers': {
  }
};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

NODEJS - USANDO UNIREST

var unirest = require('unirest');
var req = unirest('GET', 'https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR')
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });

C# USANDO RESTSHARP

var client = new RestClient("https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

JAVA USANDO UNIREST

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR")
  .asString();

JAVA USANDO OKHTTP

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();

PHP cURL

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

PYTHON REQUESTS

import requests

url = "https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR"

payload = {}
headers= {}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

RUBY

require "uri"
require "net/http"

url = URI("https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

SWIFT

import Foundation

var semaphore = DispatchSemaphore (value: 0)

var request = URLRequest(url: URL(string: "https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}

task.resume()
semaphore.wait()

GO


package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.linketrack.com/track/json?user=teste&token=1abcd00b2731640e886fb41a8a9671ad1434c599dbaa0a0de9a5aa619f29a83f&codigo=LX002249507BR"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
  }
  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

RESPOSTAS

:warning: O valor do campo subStatus varia de acordo com a fonte do rastreamento e não deve ser considerado: Este campo será descontinuado no futuro!!

200 - OK

{
  "codigo": "LX002249507BR",
  "servico": "PAC - Encomenda Econômica",
  "host": "dw",
  "quantidade": 12,
  "eventos": [
    {
      "data": "24/10/2019",
      "hora": "10:40",
      "local": "CURITIBA/PR",
      "status": "Devolução autorizada pela Receita Federal",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "11/09/2019",
      "hora": "00:00",
      "local": "CURITIBA/PR",
      "status": "Pagamento não efetuado no prazo",
      "subStatus": [
        "Objeto em análise de destinação"
      ]
    },
    {
      "data": "15/08/2019",
      "hora": "13:37",
      "local": "CURITIBA/PR",
      "status": "Encaminhado para fiscalização aduaneira",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "13/08/2019",
      "hora": "16:53",
      "local": "CURITIBA/PR",
      "status": "Encaminhado para fiscalização aduaneira",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "13/08/2019",
      "hora": "16:13",
      "local": "CURITIBA/PR",
      "status": "Encaminhado para fiscalização aduaneira",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "13/08/2019",
      "hora": "14:34",
      "local": "CURITIBA/PR",
      "status": "Encaminhado para fiscalização aduaneira",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "09/08/2019",
      "hora": "18:11",
      "local": "CURITIBA/PR",
      "status": "Aguardando pagamento",
      "subStatus": [
        "<span class=\"minhasImportacoes\">Acesse o ambiente <a href=\"https://www.correios.com.br/encomendas-logistica/minhas-importacoes/minhas-importacoes\" target=\"_blank\">Minhas Importações</a></span>"
      ]
    },
    {
      "data": "09/08/2019",
      "hora": "15:23",
      "local": "CURITIBA/PR",
      "status": "Encaminhado para fiscalização aduaneira",
      "subStatus": [
        "Registrado por CENTRO INTERNACIONAL PR - CURITIBA/PR"
      ]
    },
    {
      "data": "09/08/2019",
      "hora": "12:22",
      "local": "CURITIBA/PR",
      "status": "Objeto encaminhado",
      "subStatus":

CorreiosApi

Install / Use

README