> ## Documentation Index > Fetch the complete documentation index at: https://docs.agulhao.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Buscar produtos > Retorna lista de produtos cadastrados no Agulhão ## OpenAPI ````yaml /api/openapi.yaml get /produtos openapi: 3.0.1 info: title: Agulhão API description: API do sistema Agulhão version: 1.0.1 contact: email: contato@softros.com.br url: https://agulhao.com.br servers: - url: https://api-integracoes.agulhao.com.br description: Produção security: - chaveApi: [] tags: - name: produtos - name: pedidos - name: pessoas - name: tipos-lancamento - name: filiais paths: /produtos: get: tags: - produtos summary: Buscar produtos description: Retorna lista de produtos cadastrados no Agulhão operationId: getProdutos parameters: - name: pagina in: query description: Número da página para paginação dos resultados required: false schema: type: integer default: 1 example: 1 - name: qtdePorPagina in: query description: Quantidade de produtos por página required: false schema: type: integer default: 100 example: 10 - name: ultimaAtualizacao in: query description: Data da última atualização dos produtos (formato ISO 8601) required: false schema: type: string format: date-time example: '2025-01-01T00:00:00Z' - name: marcas in: query description: Filtra produtos por marcas (IDs separados por vírgula) required: false schema: type: string example: 1,2,3 - name: grupos in: query description: Filtra produtos por departamentos (IDs separados por vírgula) required: false schema: type: string example: 1,2,3 - name: subGrupos in: query description: Filtra produtos por grupos (IDs separados por vírgula) required: false schema: type: string example: 1,2,3 - name: fornecedorCod in: query description: Filtra produtos por código do fornecedor required: false schema: type: string enum: - '1' - '0' example: '1' - name: comEstoque in: query description: Filtra produtos que possuem estoque required: false schema: type: string enum: - '1' - '0' example: '1' - name: semEstoque in: query description: Filtra produtos que não possuem estoque required: false schema: type: string enum: - '1' - '0' example: '1' - name: precoMin in: query description: Filtra produtos com preço mínimo required: false schema: type: string example: '10.00' - name: precoMax in: query description: Filtra produtos com preço máximo required: false schema: type: string example: '100.00' - name: filialCod in: query description: Filtra produtos por código da filial required: false schema: type: string example: '1' - name: radioStatus in: query description: Filtra produtos pelo status (A - Ativo, I - Inativo) required: false example: [] schema: type: string enum: - A - I example: A - name: pesquisa in: query description: Pesquisa pela descrição do produto required: false schema: type: string example: Produto - name: codigoOriginal in: query description: Filtra produtos pelo código original required: false schema: type: string example: REF123 - name: codigoInterno in: query description: Filtra produtos pelo código interno required: false schema: type: string example: '1' responses: '200': description: Sucesso content: application/json: schema: type: array items: type: object properties: id: type: integer description: Identificador único do produto nomePersonalizado: type: string description: Nome personalizado do produto descricao: type: string description: Descrição do produto nomeAbreviado: type: string description: Prod. Abreviado referencia: type: string description: Referência do produto nome: type: string description: Nome do Produto sexo: type: string description: Sexo do produto (M, F, U) enum: - M - F - U example: M marca: type: string description: Marca do Produto altura: type: number description: Altura do produto em centímetros largura: type: integer description: Largura do produto em centímetros comprimento: type: integer description: Comprimento do produto em centímetros peso: type: number description: Peso do produto em kg unidadeMedidaSigla: type: string description: Sigla da unidade de medida do produto ativo: type: boolean description: Indica se o produto está ativo precoMinimo: type: integer description: Preço mínimo do produto grupo: type: integer departamento: type: integer precoMaximo: type: integer description: Preço máximo do produto ultimaAlteracao: type: string description: Data da última atualização do produto example: '2025-01-01T00:00:00Z' cores: type: array items: type: object properties: id: type: integer description: Identificador único da cor nome: type: string description: Nome da cor hexadecimal: type: string description: Código hexadecimal da cor example: '#0000FF' url: type: string description: URL da imagem da cor marcadores: type: array items: type: object properties: id: type: integer description: Identificador único do marcador nome: type: string description: Nome do marcador imagens: type: array items: type: object properties: id: type: integer description: Identificador único da imagem url: type: string description: URL da imagem do produto ordem: type: integer description: Ordem de exibição da imagem idCor: type: integer description: >- Identificador da cor associada à imagem (se aplicável) grades: type: array items: type: object properties: numero: type: string description: Número da grade do produto id: type: integer description: Identificador único da grade do produto ean: type: string description: EAN (código de barras) da grade do produto disponivelVenda: type: boolean disponivelEcommerce: type: boolean disponivelCorte: type: boolean ordem: type: number idCor: type: integer description: >- Identificador da cor associada à grade do produto (se aplicável) preco: type: number description: Preço da grade do produto precoPromocional: type: number description: >- Preço promocional da grade do produto (se aplicável) estoque: type: integer description: Quantidade em estoque da grade do produto example: - id: 1 nomePersonalizado: Produto Personalizado descricao: Descrição do produto nomeAbreviado: Prod. Abreviado referencia: REF123 nome: Nome do Produto sexo: M marca: Marca do Produto altura: 10.5 largura: 20 comprimento: 30 peso: 0.57 unidadeMedidaSigla: UN ativo: true precoMinimo: 10 precoMaximo: 100 ultimaAlteracao: '2025-01-01T00:00:00Z' cores: - id: 1 nome: Azul hexadecimal: '#0000FF' url: https://example.com/cor-azul.png marcadores: - id: 1 nome: Marcador 1 imagens: - id: 1 url: https://example.com/imagem-produto.png ordem: 1 idCor: 1 grades: - numero: M id: 1 ean: '1234567890123' idCor: 1 preco: 50 precoPromocional: 45 estoque: 100 headers: {} deprecated: false security: - chaveApi: [] components: securitySchemes: chaveApi: description: Chave da API gerada no agulhão type: apiKey name: x-api-key in: header ````