> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centralcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Costs

> Lista os custos cadastrados na loja.



## OpenAPI

````yaml /openapi/costs.yaml get /app/cost
openapi: 3.1.0
info:
  title: CentralCart API
  version: 1.0.0
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security:
  - bearerAuth: []
paths:
  /app/cost:
    get:
      tags:
        - Custos
      summary: List Costs
      description: Lista os custos cadastrados na loja.
      operationId: listCosts
      responses:
        '200':
          description: Lista de custos, do mais recente para o mais antigo.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Cost'
              example:
                - id: 41
                  store_id: 2
                  name: Hospedagem do servidor
                  description: VPS dedicada
                  amount: 189.9
                  frequency: MONTHLY
                  starts_at: '2026-01-01'
                  ends_at: null
                  created_at: '2026-11-10T18:52:10.000-03:00'
                  updated_at: '2026-11-10T18:52:10.000-03:00'
                - id: 38
                  store_id: 2
                  name: Banner de divulgação
                  description: null
                  amount: 250
                  frequency: ONCE
                  starts_at: '2026-10-15'
                  ends_at: null
                  created_at: '2026-10-15T09:01:44.000-03:00'
                  updated_at: '2026-10-15T09:01:44.000-03:00'
components:
  schemas:
    Cost:
      type: object
      properties:
        id:
          type: number
          description: ID do custo
        store_id:
          type: number
          description: ID da loja
        name:
          type: string
          description: Nome do custo
        description:
          type:
            - string
            - 'null'
          description: Descrição do custo
        amount:
          type: number
          description: Valor do custo em reais, por ocorrência
        frequency:
          type: string
          enum:
            - MONTHLY
            - WEEKLY
            - YEARLY
            - ONCE
          description: 'Frequência: mensal, semanal, anual ou avulso (`ONCE`)'
        starts_at:
          type: string
          format: date
          description: Data de início, no formato `AAAA-MM-DD`
        ends_at:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Data de fim, no formato `AAAA-MM-DD`. Nulo quando o custo não tem
            fim ou é avulso
        created_at:
          type: string
          description: Data de cadastro do custo
        updated_at:
          type: string
          description: Data da última atualização do custo
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Token de API gerado no painel da CentralCart.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.