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

# Listar convênios

`GET /v5/transactions/institutions`

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.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/versions/85dd6188a37b/schema)