---
title: "Listar convênios DA"
method: GET
path: "/eda/v1/utilities/da"
---

# Listar convênios DA

`GET /eda/v1/utilities/da`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/eda/v1/utilities/da`
- Auth: OAuth 2

Essa API irá retornar todos os convênios disponíveis para o uso do débito automático.

Recomendamos que esses convênios sejam armazenados do lado da sua aplicação, dessa forma, com os dados em memória fica mais fácil apresentá-los ao seus usuários.

Criamos um [artigo](https://developers.celcoin.com.br/docs/da-d%C3%A9bito-autom%C3%A1tico) que explica como realizar essa requisição.

Com essa API é possível listar os convênios de acordo com os segmentos disponíveis, sendo eles:

Não definido (será retornado todos convênios disponíveis);
1: Prefeituras;
2: Saneamento;
3: Energia Elétrica e Gás;
4: Telecomunicações;
6: Carnês e Assemelhados ou Demais

## Query parameters

- `segment` integer

## Response `200`

200

- object[]
  - `utilityId` integer
  - `name` string
  - `shortName` string
  - `utilityCode` string
  - `diasAtivacao` integer
  - `diasOcorrencia` integer
  - `subscriptionRoleIdentification` string
  - `utilityInputs` object[]
    - `utilityInputId` integer
    - `placeHolder` string
    - `minLength` integer
    - `maxLength` integer
    - `dataType` string
    - `description` string
  - `segment` object
    - `id` integer
    - `name` string

## Other responses

- `400`: 400
- `500`: 500

---

[API](https://skmtc.dev/celcoin/apis/api-para-pix-1.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-pix-1/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-pix-1/revisions/02305f8800d4?raw)