---
title: "Listar convênios"
method: GET
path: "/v5/transactions/institutions"
---

# Listar convênios

`GET /v5/transactions/institutions`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/v5/transactions/institutions`
- Auth: OAuth 2

Com essa API é possível listar todos os convênios de concessionárias e tributos que estão disponíveis para pagamento na base da Celcoin. Além de ser possível saber à quais localidades eles pertencem.

## Query parameters

- `Type` 'NACIONAL' | 'ESTADUAL'
- `UF` string[]

## Response `200`

200

- union
  - object
    - `convenants` object[]
      - `timeLimit` string
      - `mask` string
      - `nomeconvenant` string
      - `type` string
      - `UF` string[]
  - object
    - `convenants` object[]
      - `timeLimit` string
      - `mask` string
      - `nomeconvenant` string
      - `type` string
      - `UF` string[]

## Other responses

- `401`: 401
- `500`: 500

---

[API](https://skmtc.dev/celcoin/apis/transfer-ncias.md) - [All operations](https://skmtc.dev/celcoin/apis/transfer-ncias/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/transfer-ncias/revisions/800929a1928e?raw)