> ## Documentation Index > Fetch the complete documentation index at: https://docs.startgov.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Consultar ordem por número > Retorna os dados completos de uma Ordem de Fornecimento a partir do seu número. Requer token de acesso do órgão emissor da ordem no header `Authorization`. ## OpenAPI ````yaml GET /orders openapi: 3.0.3 info: title: StartGov — BID version: 1.0.0 description: >- API autenticada do módulo BID da plataforma StartGov. Atualmente expõe consulta de Ordens de Fornecimento. Novos recursos serão adicionados sob a mesma autenticação. servers: - url: https://api-bid.startgov.com.br/external description: Produção security: - ApiKeyAuth: [] tags: - name: Ordens description: Consulta de Ordens de Fornecimento paths: /orders: get: tags: - Ordens summary: Consultar ordem por número description: >- Retorna os dados completos de uma Ordem de Fornecimento a partir do seu número. Requer token de acesso do órgão emissor da ordem no header `Authorization`. operationId: getOrderByNumber parameters: - name: order_number in: query required: true description: Número da ordem a consultar. schema: type: string example: 27551-2024 responses: '200': description: Ordem recuperada com sucesso content: application/json: schema: $ref: '#/components/schemas/OrderResponse' example: message: Ordem recuperada com sucesso data: number: 27551-2024 unity_name: Secretaria Municipal de Saúde unity_name_short: SEMUS object: Fornecimento de Medicamentos e Correlatos process_number: '0045.2023' bidding_number: 025/2023 modality_name: Pregão Eletrônico status_title: Emitida provider_name: MILAZZO CAVALCANTE COMERCIO E DISTRIBUIDORA LTDA provider_document: '28863972000129' representative_name: LUCAS MILAZZO DE CASTRO E SILVA arp_number: null arp_amount_total: null contract_number: 076/2024 contract_amount_total: 405515.5 expense_classification_title: >- 10.301.2003.2058.0000 - MANUTENCAO DO FUNDO MUNICIPAL DE SAUDE expense_type_title: 3.3.90.30.00 - MATERIAL DE CONSUMO location_delivery: Avenida Davi Alves Silva, S/N, Santa Lucia deadline_delivery: '2024-08-08T03:00:00.000000Z' invoice_number: null invoice_issue_date: null amount_total: 41278.65 items: - number_item: '181' description: FILME RAIO X 35X35 C/100 brand: FUJIFILM unit_measurement: CAIXA quantity: 2 amount: 501 amount_total: 1002 - number_item: '182' description: FILME RAIO X 35X43 C/100 brand: FUJIFILM unit_measurement: CAIXA quantity: 2 amount: 619 amount_total: 1238 - number_item: '183' description: FITA ADESIVA HOSPITALAR 16MM/50M brand: CREMER unit_measurement: UNIDADE quantity: 273 amount: 3.65 amount_total: 996.45 '401': description: Token ausente, malformado ou inválido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Unauthorized data: [] '429': description: Limite de 60 requisições por segundo excedido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Too Many Requests data: [] '500': description: Erro de validação ou ordem não encontrada content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing: summary: Número da ordem não informado value: message: Número da ordem é obrigatório data: [] notFound: summary: Ordem não encontrada value: message: Ordem não encontrada data: [] security: - ApiKeyAuth: [] components: schemas: OrderResponse: type: object properties: message: type: string example: Ordem recuperada com sucesso data: $ref: '#/components/schemas/Order' ErrorResponse: type: object properties: message: type: string example: Ordem não encontrada data: type: array items: {} example: [] Order: type: object properties: number: type: string example: 27551-2024 description: Número da ordem unity_name: type: string example: Secretaria Municipal de Saúde description: Nome completo da unidade responsável unity_name_short: type: string example: SEMUS description: Nome abreviado da unidade responsável object: type: string example: Fornecimento de Medicamentos e Correlatos description: Objeto da ordem process_number: type: string nullable: true example: '0045.2023' description: Número do processo administrativo bidding_number: type: string nullable: true example: 025/2023 description: Número da licitação ou contratação modality_name: type: string description: Modalidade da licitação ou contratação pública example: Pregão Eletrônico enum: - Adesão - Pregão Eletrônico - Pregão Presencial - Tomada de Preço - Concorrência - Presencial - Chamamento Público - Carta Convite - Dispensa sem Disputa - Inexigibilidade - Leilão Presencial - Regime Diferenciado de Contratação - Dispensa Eletrônica - Diálogo Competitivo - Procedimento da Lei 13.393/2016 - Concurso - Concorrência - Eletrônica - Manifestação de Interesse - Pré-Qualificação - Credenciamento - Leilão Eletrônico status_title: type: string description: Status atual da ordem example: Emitida enum: - Emitida - Recebido total - Recebido parcialmente - Recebido provisoriamente provider_name: type: string example: MILAZZO CAVALCANTE COMERCIO E DISTRIBUIDORA LTDA description: Nome do fornecedor responsável provider_document: type: string example: '28863972000129' description: Documento do fornecedor (CNPJ ou CPF) representative_name: type: string example: LUCAS MILAZZO DE CASTRO E SILVA description: Nome do representante do fornecedor arp_number: type: string nullable: true example: null description: Número do ARP (quando aplicável) arp_amount_total: type: number format: float nullable: true example: null description: Valor total do ARP (quando aplicável) contract_number: type: string nullable: true example: 076/2024 description: Número do contrato (quando aplicável) contract_amount_total: type: number format: float nullable: true example: 405515.5 description: Valor total do contrato (quando aplicável) expense_classification_title: type: string example: 10.301.2003.2058.0000 - MANUTENCAO DO FUNDO MUNICIPAL DE SAUDE description: Classificação da despesa expense_type_title: type: string example: 3.3.90.30.00 - MATERIAL DE CONSUMO description: Tipo de despesa location_delivery: type: string example: Avenida Davi Alves Silva, S/N, Santa Lucia description: Local de entrega deadline_delivery: type: string format: date-time example: '2024-08-08T03:00:00.000000Z' description: Prazo de entrega invoice_number: type: string nullable: true example: null description: Número da nota fiscal (quando aplicável) invoice_issue_date: type: string format: date-time nullable: true example: null description: Data de emissão da nota fiscal (quando aplicável) amount_total: type: number format: float example: 41278.65 description: Valor total da ordem items: type: array description: Itens que compõem a ordem items: $ref: '#/components/schemas/OrderItem' OrderItem: type: object properties: number_item: type: string example: '181' description: Número do item description: type: string example: FILME RAIO X 35X35 C/100 description: Descrição do item brand: type: string example: FUJIFILM description: Marca do item unit_measurement: type: string example: CAIXA description: Unidade de medida quantity: type: integer example: 2 description: Quantidade do item amount: type: number format: float example: 501 description: Valor unitário do item amount_total: type: number format: float example: 1002 description: Valor total do item securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: >- Token de acesso emitido por órgão. Envie o valor cru no header `Authorization` — sem prefixo `Bearer`. Solicite o token enviando os dados da sua empresa para yves.cleuder@startgov.com.br. ````