---
title: "Consulta Limites da Conta"
method: GET
path: "/accounts/{account}/limits"
---

# Consulta Limites da Conta

`GET /accounts/{account}/limits`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev/baas/v2`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v2/accounts/{account}/limits`
- Auth: OAuth 2

## Path parameters

- `account` string, required

## Query parameters

- `limitType` string
- `category` string

## Response `200`

- object
  - `status` string: Status do processamento da requisição. No exemplo, `SUCCESS` indica sucesso.
  - `version` string: Versão do contrato da resposta.
  - `body` object: Objeto que contém os dados retornados pela consulta.
    - `account` string: Número da conta consultada.
    - `limits` object[]: Lista de limites configurados para a conta, incluindo informações do período e do consumo.
      - `limitType` string: Identificador do tipo de limite como PixPJ, PixPF, PixPFPJ, Billpayments, TedPJ, TedPF ou Favorites.
      - `name` string: Nome descritivo do limite. Ex. Pix - Pessoa Jurídica
      - `description` string: Descrição da finalidade ou regra do limite.
      - `category` string: Categoria à qual o limite pertence, como pix.
      - `period` object: Objeto com as informações da janela de consumo do limite.
        - `type` string: Tipo de período do limite, como DAILY.
        - `label` string: Descrição da janela de utilização do limite. Ex.: Diário (00h às 23h59) ou Diurno (6h às 20h)
        - `startTime` string, date-time: Data e hora de início da janela de consumo
        - `endTime` string, date-time: Data e hora de término da janela de consumo
      - `value` integer: Valor total configurado para o limite no período.
      - `consumedValue` number: Valor já consumido do limite no período consultado
      - `remainingValue` number: Valor restante disponível para utilização no período.

## Other responses

- `400`: Bad Request
- `401`: Access Denied
- `500`: Internal Server Error

---

[API](https://skmtc.dev/celcoin/apis/baas-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/baas-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/baas-v2/revisions/98ec6869c1f2?raw)