> ## 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.

# Listar ARPs

> Retorna uma lista paginada de Atas de Registro de Preços (ARPs) publicadas no portal de transparência.



## OpenAPI

````yaml GET /transparency/arps
openapi: 3.0.3
info:
  title: StartGov — Portal da Transparência
  version: 1.0.0
  description: >-
    API pública do Portal da Transparência da plataforma StartGov. Todos os
    endpoints são públicos e não requerem autenticação.
servers:
  - url: https://api-bid.startgov.com.br/v1
    description: Produção
security: []
tags:
  - name: Licitações
    description: Processos licitatórios formais
  - name: Contratações Diretas
    description: Dispensas e inexigibilidades
  - name: Adesões
    description: Adesões a ARPs externas (carona)
  - name: Chamamentos Públicos
    description: Chamamentos públicos
  - name: ARPs
    description: Atas de Registro de Preços
  - name: Contratos
    description: Contratos de fornecimento
  - name: Ordens de Fornecimento
    description: Ordens emitidas contra contratos e ARPs
  - name: Auxiliares
    description: 'Endpoints de suporte: validação, enumerações e exportação'
paths:
  /transparency/arps:
    get:
      tags:
        - ARPs
      summary: Listar ARPs
      description: >-
        Retorna uma lista paginada de Atas de Registro de Preços (ARPs)
        publicadas no portal de transparência.
      operationId: listArps
      parameters:
        - $ref: '#/components/parameters/organization_uuid'
        - $ref: '#/components/parameters/date_from'
        - $ref: '#/components/parameters/date_to'
        - name: arps_status_id
          in: query
          description: >-
            ID do status da ARP. Use `/transparency/managementStatuses` para
            obter os IDs disponíveis.
          schema:
            type: integer
        - $ref: '#/components/parameters/bidding_modality_id'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/year'
        - $ref: '#/components/parameters/per_page'
        - name: with_relations
          in: query
          description: >-
            Relações a incluir, separadas por vírgula. Valores aceitos:
            `documents`, `terms`, `orders`, `contracts`.
          schema:
            type: string
            example: documents,terms,orders,contracts
      responses:
        '200':
          description: Lista paginada de ARPs
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/PaginatedArps'
components:
  parameters:
    organization_uuid:
      name: organization_uuid
      in: query
      required: true
      description: UUID da organização
      schema:
        type: string
        format: uuid
    date_from:
      name: date_from
      in: query
      description: >-
        Data inicial do filtro (YYYY-MM-DD). Deve ser usado em conjunto com
        `date_to`.
      schema:
        type: string
        format: date
        example: '2024-01-01'
    date_to:
      name: date_to
      in: query
      description: >-
        Data final do filtro (YYYY-MM-DD). Deve ser usado em conjunto com
        `date_from`.
      schema:
        type: string
        format: date
        example: '2024-12-31'
    bidding_modality_id:
      name: bidding_modality_id
      in: query
      description: >-
        ID da modalidade licitatória. Use `/transparency/biddingModalities` para
        obter os IDs disponíveis.
      schema:
        type: integer
    search:
      name: search
      in: query
      description: Busca textual no objeto e número do processo
      schema:
        type: string
    year:
      name: year
      in: query
      description: Filtro por ano do exercício
      schema:
        type: integer
        example: 2024
    per_page:
      name: per_page
      in: query
      description: 'Número de registros por página. Mínimo: `1`. Máximo: `100`.'
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 100
  schemas:
    SuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Dados recuperados com sucesso
        data: {}
    PaginatedArps:
      allOf:
        - $ref: '#/components/schemas/PaginationMeta'
        - type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/ArpListItem'
    PaginationMeta:
      type: object
      properties:
        current_page:
          type: integer
          example: 1
        per_page:
          type: integer
          example: 20
        total:
          type: integer
          example: 150
        last_page:
          type: integer
          example: 8
        from:
          type: integer
          example: 1
        to:
          type: integer
          example: 20
    ArpListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        id:
          type: string
          format: uuid
        bidding_uuid:
          type: string
          format: uuid
          nullable: true
        company_name:
          type: string
          example: Prefeitura Municipal de Exemplo
        object_details:
          type: string
          example: Registro de preços para combustíveis
        amount_total:
          type: string
          example: '200000.00'
        number:
          type: string
          example: 001/2024
        company_name_short:
          type: string
          example: PME
        status_id:
          type: integer
        bidding_number:
          type: string
          example: 002/2024
        bidding_modality_id:
          type: integer
        bidding_modality:
          type: string
          example: Pregão Eletrônico
        date_signature:
          type: string
          format: date
        date_expiration:
          type: string
          format: date
        precision:
          type: integer
          example: 2
        provider_company_name:
          type: string
        published_bidding:
          type: integer
          enum:
            - 0
            - 1
          description: 1 se a licitação de origem também está publicada no portal

````