{
"ok": true,
"data": {
"valid": true,
"compact": "GB82WEST12345698765432",
"country": "GB",
"checkDigits": "82",
"length": 22,
"expectedLength": 22,
"checksumOk": true,
"lengthOk": true,
"issues": []
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39157/validate+an+iban' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"iban":"GB82 WEST 1234 5698 7654 32"}'
{
"ok": true,
"data": {
"valid": true,
"brand": "visa",
"last4": "1111",
"length": 16,
"luhnOk": true,
"issues": [],
"note": "Format and checksum only. This does not authorize a charge, confirm the card exists, or verify the cardholder."
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39158/validate+a+payment-card+number' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"number":"4111 1111 1111 1111"}'
{
"ok": true,
"data": {
"valid": true,
"type": "isbn-13",
"compact": "9780306406157",
"checksumOk": true,
"issues": []
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39159/validate+an+isbn-10+or+isbn-13' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"isbn":"978-0-306-40615-7"}'
{
"ok": true,
"data": {
"valid": true,
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"version": 4,
"variant": "rfc4122",
"formatOk": true,
"issues": []
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39160/validate+a+uuid' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"uuid":"550e8400-e29b-41d4-a716-446655440000"}'
{
"ok": true,
"data": {
"valid": true,
"email": "[email protected]",
"local": "dev",
"domain": "example.com",
"formatOk": true,
"issues": [],
"note": "Format only. This does not check DNS, MX records, or whether a mailbox exists."
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39161/validate+email+format' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"email":"[email protected]"}'
{
"ok": true,
"data": {
"valid": true,
"type": "ean-13",
"compact": "4006381333931",
"checksumOk": true,
"expectedCheckDigit": 1,
"issues": []
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39162/validate+an+ean+upc+or+gtin' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"code":"4006381333931"}'
{
"ok": true,
"data": {
"valid": true,
"compact": "021000021",
"checksumOk": true,
"issues": [],
"note": "Checksum only. This does not confirm the institution exists or that an account can be debited."
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39163/validate+a+us+aba+routing+number' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"number":"021000021"}'
{
"ok": true,
"data": {
"valid": true,
"value": "2026-11-15T16:15:00Z",
"kind": "date-time",
"issues": []
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39164/validate+an+iso+8601+date+or+date-time' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"value":"2026-11-15T16:15:00Z"}'
{
"ok": true,
"data": {
"count": 3,
"passed": 3,
"failed": 0,
"results": [
{
"index": 0,
"type": "iban",
"result": {
"valid": true,
"compact": "DE89370400440532013000",
"country": "DE",
"checkDigits": "89",
"length": 22,
"expectedLength": 22,
"checksumOk": true,
"lengthOk": true,
"issues": []
}
},
{
"index": 1,
"type": "email",
"result": {
"valid": true,
"email": "[email protected]",
"local": "dev",
"domain": "example.com",
"formatOk": true,
"issues": [],
"note": "Format only. This does not check DNS, MX records, or whether a mailbox exists."
}
},
{
"index": 2,
"type": "isbn",
"result": {
"valid": true,
"type": "isbn-13",
"compact": "9780306406157",
"checksumOk": true,
"issues": []
}
}
]
}
}
curl --location --request POST 'https://zylalabs.com/api/14947/format+guard+api/39165/validate+up+to+50+values+at+once' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"items":[{"type":"iban","value":"DE89370400440532013000"},{"type":"email","value":"[email protected]"},{"type":"isbn","value":"9780306406157"}]}'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Formato Guard API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Validação de checksum e formato para IBAN, cartões de pagamento, ISBN, UUID, e-mail, EAN/UPC, números de roteamento dos EUA e datas ISO 8601. Todas as verificações são calculadas localmente. Um checksum aprovado não significa um
Não Esta API apenas verifica formato e somas de verificação Não contata bancos redes de cartões ou processadores de pagamento e não pode autorizar uma cobrança
Não Números de cartão são usados apenas para calcular o verificador de Luhn e a marca e depois descartados A resposta inclui last4 marca comprimento e se a soma de verificação passou
Não. As verificações de e-mail são apenas de formato. A API não consulta registros DNS ou MX e não confirma se uma caixa de correio pode receber e-mails
HTTP 200 significa que a verificação foi executada com sucesso O resultado está em data.valid Um valor falso significa que a string falhou nas regras de verificação ou formato problemas lista os motivos HTTP 400 é reservado para solicitações malformadas
Até 50 itens por chamada Cada item precisa de um tipo e um valor Os tipos são iban cartão de crédito isbn uuid email ean número de roteamento e iso8601 Itens UUID também podem incluir versão
Datas de calendário como AAAA-MM-DD e datas-horas com segundos opcionais, um segundo fracionário e um offset Z ou ±HH:MM. As durações dos meses e anos bissextos são verificadas. Valores como 15/11/2026 são rejeitados
A API retorna HTTP 413 e não processa o corpo Mantenha cada campo no limite de comprimento documentado ou abaixo disso
Não É uma utilidade de computação pura Não procura instituições cartões ou caixas de correio e não armazena os valores que você envia
Cada endpoint retorna um objeto JSON contendo um campo booleano `ok` indicando sucesso e um campo `data` com resultados de validação específicos Por exemplo o endpoint IBAN retorna campos como `valid` `compact` `country` e `issues`
Os campos principais incluem `valid` (booleano), `compact` (valor normalizado), `length` (comprimento real), `expectedLength` (comprimento esperado), `checksumOk` (validade da soma de verificação) e `issues` (quaisquer problemas de validação encontrados)
Cada endpoint aceita um valor específico para validar, como um IBAN, número de cartão de crédito, ISBN, UUID, e-mail, EAN, número de roteamento ou data ISO 8601. Alguns endpoints permitem parâmetros opcionais, como especificar uma versão UUID
Os dados de resposta estão estruturados com um campo `ok` para sucesso geral, seguidos por um objeto `data` contendo resultados de validação detalhados. Cada resultado inclui campos relevantes específicos para o tipo de validação realizada
A API fornece validação para vários identificadores: IBANs, cartões de pagamento, ISBNs, UUIDs, e-mails, EAN/UPCs, números de roteamento dos EUA e datas ISO 8601. Cada endpoint foca na validação de formato e checksum
Os usuários podem verificar o campo `valid` para determinar se a entrada é válida Campos adicionais como `issues` fornecem informações sobre quaisquer problemas enquanto `compact` oferece um formato padronizado para processamento adicional
Casos de uso típicos incluem validar a entrada do usuário em formulários garantir a integridade dos dados em transações financeiras e verificar identificadores de produtos em sistemas de inventário Isso ajuda a prevenir erros e melhorar a qualidade dos dados
A precisão dos dados é mantida por meio de cálculos de verificação locais e validações de formato com base em padrões estabelecidos por exemplo ISO 13616 para IBANs algoritmo de Luhn para cartões de crédito A API não depende de fontes de dados externas garantindo resultados consistentes