---
title: "Obter agrupamento de expedição"
method: GET
path: "/expedicao/{idAgrupamento}"
tags: ["Expedição"]
---

# Obter agrupamento de expedição

`GET /expedicao/{idAgrupamento}`

## Request

- Base URL: `https://api.tiny.com.br/public-api/v3`
- URL: `https://api.tiny.com.br/public-api/v3/expedicao/{idAgrupamento}`
- Auth: HTTP bearer

## Path parameters

- `idAgrupamento` integer, required

## Response `200`

OK

- ObterAgrupamentoResponseModel: 
  - `id` integer
  - `identificacao` string
  - `data` string
  - `formaEnvio` FormaEnvioResponseModel: 
    - `id` integer
    - `nome` string, nullable
  - `expedicoes` ExpedicaoResponseModel[]
    - `id` integer
    - `data` string
    - `situacao` string
    - `tipoObjeto` string
    - `idObjeto` integer
    - `dataEmissao` string
    - `venda` ExpedicaoVendaResponseModel: 
      - `id` integer
      - `numero` integer, nullable
      - `data` string, nullable
      - `situacao` 8 | 0 | 3 | 4 | 1 | 7 | 5 | 6 | 10 | 2 | 9, nullable: - 8 - Dados Incompletos - 0 - Aberta - 3 - Aprovada - 4 - Preparando Envio - 1 - Faturada - 7 - Pronto Envio - 5 - Enviada - 6 - Entregue - 10 - Em Devolucao - 2 - Cancelada - 9 - Nao Entregue
    - `notaFiscal` ExpedicaoNotaResponseModel: 
      - `id` integer
      - `numero` integer, nullable
      - `data` string, nullable
      - `situacao` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10, nullable: - 1 - Pendente - 2 - Emitida - 3 - Cancelada - 4 - Enviada Aguardando Recibo - 5 - Rejeitada - 6 - Autorizada - 7 - Emitida Danfe - 8 - Registrada - 9 - Enviada Aguardando Protocolo - 10 - Denegada
    - `destinatario` ContatoModelResponse: 
      - `nome` string, nullable
      - `codigo` string, nullable
      - `fantasia` string, nullable
      - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable: - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
      - `cpfCnpj` string, nullable
      - `inscricaoEstadual` string, nullable
      - `rg` string, nullable
      - `telefone` string, nullable
      - `celular` string, nullable
      - `email` string, nullable
      - `endereco` EnderecoModel: 
        - `endereco` string, nullable
        - `numero` string, nullable
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `municipio` string, nullable
        - `cep` string, nullable
        - `uf` string, nullable
        - `pais` string, nullable
      - `id` integer
    - `volume` VolumeExpedicaoResponseModel: 
      - `embalagem` EmbalagemResponseModel: 
        - `id` integer, nullable
        - `tipo` 0 | 1 | 2 | 3, nullable: - 0 - Nao Definido - 1 - Envelope - 2 - Caixa - 3 - Cilindro
        - `descricao` string, nullable
      - `largura` number, float
      - `altura` number, float
      - `comprimento` number, float
      - `diametro` number, float
      - `pesoBruto` number, float
      - `quantidadeVolumes` integer
    - `logistica` LogisticaExpedicaoResponseModel: 
      - `codigoRastreio` string
      - `urlRastreio` string
      - `possuiValorDeclarado` boolean
      - `valorDeclarado` number, float
      - `possuiAvisoRecebimento` boolean
      - `formaFrete` FormaFreteResponseModel: 
        - `id` integer, nullable
        - `nome` string, nullable
      - `transportador` TransportadorExpedicaoResponseModel: 
        - `id` integer
        - `nome` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `107f8d039de2`: 1 warning
  - added the new `10.00` enum value to the `expedicoes/items/venda/situacao` response property for the response status `200`

[Operation history](https://skmtc.dev/olist/apis/olist-erp-api-v3/changes/expedicao/:idAgrupamento/get.md)

---

[API](https://skmtc.dev/olist/apis/olist-erp-api-v3.md) - [All operations](https://skmtc.dev/olist/apis/olist-erp-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/olist/apis/olist-erp-api-v3/revisions/107f8d039de2?raw)