ResponseBankingAgentsList

CompanyBankingFinancial ServicesPaymentsPixOpen FinanceBrazilForeign ExchangeCredit

Properties

Name	Type	Description
data	array
links	object
meta	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/itau-unibanco/main/json-schema/itau-unibanco-response-banking-agents-list-schema.json",
  "title": "ResponseBankingAgentsList",
  "x-generated": "2026-10-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/itau-unibanco-open-finance-channels-openapi.yml#/components/schemas/ResponseBankingAgentsList",
  "type": "object",
  "required": [
    "data",
    "links",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/BankingAgentsData"
      },
      "minItems": 1
    },
    "links": {
      "$ref": "#/$defs/Links"
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "$defs": {
    "BankingAgent": {
      "type": "object",
      "required": [
        "identification",
        "locations",
        "services"
      ],
      "properties": {
        "identification": {
          "$ref": "#/$defs/BankingAgentIdentification"
        },
        "locations": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BankingAgentLocation"
          },
          "minItems": 1,
          "description": "Relação de informações referentes as localizações do correspondente bancário"
        },
        "services": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BankingAgentService"
          },
          "minItems": 1,
          "description": "Traz a relação de serviços disponbilizados pelo Canal de Atendimento"
        },
        "contractors": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BankingAgentsContractor"
          },
          "minItems": 1,
          "description": "Relação de informações de um contratante do serviço de correspondente."
        }
      }
    },
    "BankingAgentAvailability": {
      "type": "object",
      "description": "Horário de funcionamento das operações",
      "properties": {
        "standards": {
          "description": "Lista disponibilidade padrão da dependência por dias da semana",
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "weekday"
            ],
            "properties": {
              "weekday": {
                "type": "string",
                "enum": [
                  "DOMINGO",
                  "SEGUNDA_FEIRA",
                  "TERCA_FEIRA",
                  "QUARTA_FEIRA",
                  "QUINTA_FEIRA",
                  "SEXTA_FEIRA",
                  "SABADO"
                ],
                "description": "Dia da semana de abertura"
              },
              "openingTime": {
                "type": "string",
                "description": "Horário de abertura (UTC)",
                "maxLength": 13,
                "pattern": "^(?:[01]\\d|2[0123]):(?:[012345]\\d):(?:[012345]\\d)Z$"
              },
              "closingTime": {
                "type": "string",
                "description": "Horário de fechamento (UTC)",
                "maxLength": 13,
                "pattern": "^(?:[01]\\d|2[0123]):(?:[012345]\\d):(?:[012345]\\d)Z$"
              }
            }
          }
        },
        "exception": {
          "type": "string",
          "description": "Em campo texto devem ser registradas todas as Exceções para o não atendimento",
          "maxLength": 2000,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "isPublicAccessAllowed": {
          "description": "Indica se a instalação da Dependência tem acesso restrito a clientes",
          "type": "boolean"
        }
      }
    },
    "BankingAgentIdentification": {
      "type": "object",
      "description": "Lojas do correspondente bancário",
      "required": [
        "cnpjNumber",
        "corporationName",
        "isUnderestablishment"
      ],
      "x-regulatory-required": [
        "corporationName",
        "groupName",
        "isUnderestablishment"
      ],
      "properties": {
        "corporationName": {
          "type": "string",
          "description": "Nome da loja do correspondente bancário",
          "maxLength": 100,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "groupName": {
          "type": "string",
          "description": "Nome do grupo do correspondente bancário",
          "maxLength": 100,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "isUnderestablishment": {
          "type": "boolean",
          "description": "Indicador do Correspondente Bancário ser um Substabelecimento (são empresas  que foram contratadas por um correspondente bancário para prestar serviços. A empresa substabelecida é tratada como um correspondente do banco e tem praticamente os mesmos direitos e obrigações que possui o correspondente direto)"
        },
        "cnpjNumber": {
          "type": "string",
          "pattern": "^\\d{14}$",
          "description": "Número completo do CNPJ da instituição",
          "maxLength": 14,
          "minLength": 14
        }
      }
    },
    "BankingAgentLocation": {
      "type": "object",
      "required": [
        "postalAddress"
      ],
      "properties": {
        "postalAddress": {
          "$ref": "#/$defs/BankingAgentPostalAddress"
        },
        "availability": {
          "$ref": "#/$defs/BankingAgentAvailability"
        },
        "phones": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Phone"
          }
        }
      }
    },
    "BankingAgentPostalAddress": {
      "type": "object",
      "description": "Informação referente ao endereço postal",
      "required": [
        "address",
        "districtName",
        "townName",
        "countrySubDivision",
        "postCode"
      ],
      "x-regulatory-required": [
        "address",
        "districtName",
        "townName",
        "countrySubDivision",
        "postCode"
      ],
      "properties": {
        "address": {
          "type": "string",
          "description": "Deverá trazer toda a informação referente ao endereço da dependência informada: Tipo de logradouro + Nome do logradouro + Número do Logradouro (se não existir usar ' s/n') + complemento (se houver), como, p.ex.: 'R Diamatina, 59, bloco 35, fundos' 'Praça da Boa Vontade s/n'",
          "maxLength": 150,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "additionalInfo": {
          "type": "string",
          "description": "Alguns logradouros ainda necessitam ser especificados por meio de complemento",
          "maxLength": 30,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "districtName": {
          "type": "string",
          "description": "Bairro é uma comunidade ou região localizada em uma cidade ou município de acordo com as suas subdivisões geográficas. p.ex: 'Paraíso'",
          "maxLength": 50,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "townName": {
          "type": "string",
          "description": "Localidade: O nome da localidade corresponde à designação da cidade ou município no qual o endereço está localizado. p.ex. 'São Paulo'",
          "maxLength": 50,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "ibgeCode": {
          "type": "string",
          "description": "Código IBGE do município",
          "maxLength": 7,
          "minLength": 7,
          "pattern": "^\\d{7}$"
        },
        "countrySubDivision": {
          "type": "string",
          "description": "Enumeração referente a cada sigla da unidade da federação que identifica o estado ou o distrito federal, no qual o endereço está localizado. p.ex. 'AC'. São consideradas apenas as siglas para os estados brasileiros",
          "enum": [
            "AC",
            "AL",
            "AP",
            "AM",
            "BA",
            "CE",
            "DF",
            "ES",
            "GO",
            "MA",
            "MT",
            "MS",
            "MG",
            "PA",
            "PB",
            "PR",
            "PE",
            "PI",
            "RJ",
            "RN",
            "RS",
            "RO",
            "RR",
            "SC",
            "SP",
            "SE",
            "TO"
          ]
        },
        "postCode": {
          "type": "string",
          "description": "Código de Endereçamento Postal",
          "pattern": "^\\d{8}$",
          "maxLength": 8,
          "minLength": 8
        },
        "country": {
          "type": "string",
          "description": "Nome do país",
          "maxLength": 80,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "countryCode": {
          "type": "string",
          "description": "Código do país de acordo com a ISO 3166-1 alpha-3",
          "minLength": 3,
          "maxLength": 3,
          "pattern": "^([A-Z]{3})$"
        },
        "geographicCoordinates": {
          "$ref": "#/$defs/GeographicCoordinates"
        }
      }
    },
    "BankingAgentService": {
      "type": "object",
      "x-regulatory-required": [
        "name",
        "code"
      ],
      "properties": {
        "name": {
          "type": "string",
          "enum": [
            "RECEPCAO_ENCAMINHAMENTO_PROPOSTAS_ABERTURA_CONTAS_DEPOSITOS_VISTA_PRAZO_POUPANCA_MANTIDOS_INSTITUICAO_CONTRATANTE",
            "REALIZACAO_RECEBIMENTOS_PAGAMENTOS_TRANSFERENCIAS_ELETRONICAS_VISANDO_MOVIMENTACAO_CONTAS_DEPOSITOS_TITULARIDADE_CLIENTES_MANTIDAS_INSTITUICAO_CONTRATANTE",
            "RECEBIMENTOS_PAGAMENTOS_QUALQUER_NATUREZA_OUTRAS_ATIVIDADES_DECORRENTES_EXECUCAO_CONTRATOS_CONVENIOS_PRESTACAO_SERVICOS",
            "EXECUCAO_ATIVA_PASSIVA_ORDENS_PAGAMENTO_CURSADAS_INTERMEDIO_INSTITUICAO_CONTRATANTE_SOLICITACAO_CLIENTES_USUARIOS",
            "RECEPCAO_ENCAMINHAMENTO_PROPOSTAS_OPERACAO_CREDITO_ARRENDAMENTO_MERCANTIL_CONCESSAO_INSTITUICAO_CONTRATANTE",
            "RECEBIMENTOS_PAGAMENTOS_RELACIONADOS_LETRAS_CAMBIO_ACEITE_INSTITUICAO_CONTRATANTE",
            "RECEPCAO_ENCAMINHAMENTO_PROPOSTAS_FORNECIMENTO_CARTAO_CREDITO_RESPONSABILIDADE_INSTITUICAO_CONTRATANTE",
            "REALIZACAO_OPERACOES_CAMBIO_RESPONSABILIDADE_INSTITUICAO_CONTRATANTE",
            "OUTROS"
          ],
          "description": "Relação dos Nomes de serviços prestados pelo Correspondente"
        },
        "code": {
          "type": "string",
          "enum": [
            "RECEBE_ENCAMINHA_PROPOSTAS_ABERTURA_CONTAS",
            "REALIZA_RECEBIMENTOS_PAGAMENTOS_TRANSFERENCIAS_ELETRONICAS",
            "RECEBIMENTOS_PAGAMENTOS_QUALQUER_NATUREZA_EXECUCAO_CONTRATOS_CONVENIO",
            "EXECUCAO_ATIVA_PASSIVA_ORDENS_PAGAMENTO",
            "RECEBE_ENCAMINHA_PROPOSTAS_CREDITO_ARRENDAMENTO_MERCANTIL",
            "RECEBE_PAGAMENTOS_RELACIONADOS_LETRAS_CAMBIO_ACEITE_INSTITUICAO",
            "RECEBE_ENCAMINHA_PROPOSTAS_FORNECIMENTO_CARTAO_CREDITO",
            "REALIZA_OPERACOES_CAMBIO",
            "OUTROS"
          ],
          "description": "> Relação dos Códigos relativos aos serviços prestados pelo Correspondente \n* `RECEBE_ENCAMINHA_PROPOSTAS_ABERTURA_CONTAS` - Recepção e encaminhamento de propostas de abertura de contas \n* `REALIZA_RECEBIMENTOS_PAGAMENTOS_TRANSFERENCIAS_ELETRONICAS` - Realização de recebimentos, pagamentos e transferências eletrônicas \n* `RECEBIMENTOS_PAGAMENTOS_QUALQUER_NATUREZA_EXECUCAO_CONTRATOS_CONVENIO` - Recebimentos e pagamentos de qualquer natureza \n* `EXECUCAO_ATIVA_PASSIVA_ORDENS_PAGAMENTO` - Execução ativa e passiva de ordens de pagamento \n* `RECEBE_ENCAMINHA_PROPOSTAS_CREDITO_ARRENDAMENTO_MERCANTIL` - Recepção e encaminhamento de propostas de operações de crédito e de arrendamento mercantil \n* `RECEBE_PAGAMENTOS_RELACIONADOS_LETRAS_CAMBIO_ACEITE_INSTITUICAO` - Recebimento e pagamentos relacionados a letras de câmbio de aceite da instituição \n* `RECEBE_ENCAMINHA_PROPOSTAS_FORNECIMENTO_CARTAO_CREDITO` - Recepção e encaminhamento de propostas de fornecimento de cartões de crédito \n* `REALIZA_OPERACOES_CAMBIO` - Realização de operações de câmbio \n* `OUTROS` - Outros"
        },
        "additionalInfo": {
          "type": "string",
          "description": "Campo aberto para detalhamento",
          "maxLength": 2000,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        }
      },
      "required": [
        "name",
        "code"
      ]
    },
    "BankingAgentsContractor": {
      "type": "object",
      "required": [
        "name",
        "cnpjNumber"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Nome do contratante do serviço de correspondente",
          "maxLength": 100,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$"
        },
        "cnpjNumber": {
          "type": "string",
          "pattern": "^\\d{14}$",
          "description": "Número completo do CNPJ da instituição",
          "maxLength": 14,
          "minLength": 14
        }
      }
    },
    "BankingAgentsData": {
      "type": "object",
      "description": "Conjunto de informações referente aos correspondentes bancários da Instituição",
      "properties": {
        "participant": {
          "$ref": "#/$defs/BankingAgentsParticipant"
        },
        "bankingAgents": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BankingAgent"
          },
          "minItems": 1
        }
      }
    },
    "BankingAgentsParticipant": {
      "description": "Conjunto de informações relativas ao participante do produto de Open Finance",
      "type": "object",
      "required": [
        "brand",
        "name",
        "cnpjNumber"
      ],
      "x-regulatory-required": [
        "brand",
        "name",
        "cnpjNumber"
      ],
      "properties": {
        "brand": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$",
          "description": "Nome da marca selecionada pela Organização proprietário da dependência (titular)."
        },
        "name": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1,
          "pattern": "^(?!\\s)[\\w\\W\\s]*[^\\s]$",
          "description": "Nome da Instituição, pertencente à marca, responsável pelo Correspondente Bancário no país."
        },
        "cnpjNumber": {
          "type": "string",
          "pattern": "^\\d{14}$",
          "description": "Número completo do CNPJ da instituição",
          "maxLength": 14,
          "minLength": 14
        }
      }
    },
    "GeographicCoordinates": {
      "type": "object",
      "description": "Informação referente a geolocalização informada.",
      "properties": {
        "latitude": {
          "description": "Informação da latitude referente a geolocalização informada.",
          "type": "string",
          "pattern": "^-?\\d{1,2}\\.\\d{1,9}$",
          "maxLength": 13,
          "minLength": 4
        },
        "longitude": {
          "description": "Informação da longitude referente a geolocalização informada.",
          "type": "string",
          "pattern": "^-?\\d{1,3}\\.\\d{1,8}$",
          "maxLength": 13,
          "minLength": 4
        }
      }
    },
    "Links": {
      "type": "object",
      "description": "Referências para outros recursos da API requisitada",
      "properties": {
        "self": {
          "type": "string",
          "format": "url",
          "description": "URL da página atualmente requisitada",
          "maxLength": 2000,
          "minLength": 5
        },
        "first": {
          "type": "string",
          "format": "url",
          "description": "URL da primeira página de registros",
          "maxLength": 2000,
          "minLength": 5
        },
        "prev": {
          "type": "string",
          "format": "url",
          "description": "URL da página anterior de registros",
          "maxLength": 2000,
          "minLength": 5
        },
        "next": {
          "type": "string",
          "format": "url",
          "description": "URL da próxima página de registros",
          "maxLength": 2000,
          "minLength": 5
        },
        "last": {
          "type": "string",
          "format": "url",
          "description": "URL da última página de registros",
          "maxLength": 2000,
          "minLength": 5
        }
      }
    },
    "Meta": {
      "type": "object",
      "description": "Meta informações referente à API requisitada",
      "properties": {
        "totalRecords": {
          "type": "integer",
          "description": "Total de registros encontrados"
        },
        "totalPages": {
          "type": "integer",
          "description": "Total de páginas para os registros encontrados"
        }
      },
      "required": [
        "totalRecords",
        "totalPages"
      ]
    },
    "Phone": {
      "type": "object",
      "description": "Lista de telefones do agente bancária",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "FIXO",
            "MOVEL"
          ],
          "description": "Identificação do Tipo de telefone da dependência. p.ex.FIXO, MOVEL."
        },
        "countryCallingCode": {
          "type": "string",
          "maxLength": 4,
          "minLength": 1,
          "pattern": "^\\d{1,4}$",
          "description": "Número de DDI (Discagem Direta Internacional) para  telefone de acesso ao Canal - se houver. p.ex. '55'"
        },
        "areaCode": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "pattern": "^\\d{2}$",
          "description": "Número de DDD (Discagem Direta à Distância) do telefone da dependência - se houver. p.ex. '19'"
        },
        "number": {
          "type": "string",
          "maxLength": 11,
          "minLength": 8,
          "pattern": "^([0-9]{8,11})$",
          "description": "Número de telefone da dependência - se houver"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/itau-unibanco-response-banking-agents-list"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.