Poštár

Dokumentace API

Možnosti vyhledávání

Použijte vyhledávací endpointy k ověření, zda účastník existuje v síti Peppol, a ke kontrole podporovaných možností dokumentů.

Dostupné endpointy

  • GET https://look.peppos.cz/api/lookup/vat/{vatId}
  • GET https://look.peppos.cz/api/lookup/peppol/{peppolId}
  • GET https://look.peppos.cz/api/lookup/{country}/{ico}
  • POST https://look.peppos.cz/api/lookup/batch

Možnosti dotazu

ParameterTypeDescription
extendedbooleanAdds additional details (currently businessCard).
You can use ?extended, ?extended=true, or ?extended=1.

Ukázkové dotazy

# VAT lookup (normal mode)
GET https://look.peppos.cz/api/lookup/vat/CZ12345678

# VAT lookup (extended mode)
GET https://look.peppos.cz/api/lookup/vat/CZ12345678?extended

# Peppol ID lookup (extended mode)
GET https://look.peppos.cz/api/lookup/peppol/0192:87654321?extended=true

# Country + ICO lookup
GET https://look.peppos.cz/api/lookup/cz/12345678

# Batch lookup
POST https://look.peppos.cz/api/lookup/batch
Content-Type: application/json

{
  "identifiers": [
    "CZ12345678",
    "vat/CZ12345678",
    "cz/12345678",
    "CZ/12345678",
    "0192:87654321"
  ]
}

Ukázkové odpovědi

Normal mode response

{
  "success": true,
  "data": {
    "peppolId": "0192:87654321",
    "scheme": "iso6523-actorid-upis",
    "exists": true,
    "capabilities": {
      "canReceiveInvoices": true,
      "canReceiveOrders": true,
      "documentTypes": [
        "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
      ]
    },
    "cachedAt": "2026-04-26T11:13:19.298Z",
    "originalIdentifier": "CZ12345678"
  }
}

Extended mode response

{
  "success": true,
  "data": {
    "peppolId": "0192:87654321",
    "scheme": "iso6523-actorid-upis",
    "exists": true,
    "businessCard": {
      "exists": true,
      "entities": []
    },
    "capabilities": {
      "canReceiveInvoices": true,
      "canReceiveOrders": true,
      "documentTypes": [
        "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
      ]
    },
    "cachedAt": "2026-04-26T11:13:19.298Z",
    "originalIdentifier": "CZ12345678"
  }
}

Batch response

{
  "success": true,
  "data": [
    {
      "peppolId": "0192:87654321",
      "scheme": "iso6523-actorid-upis",
      "exists": true,
      "capabilities": {
        "canReceiveInvoices": true,
        "canReceiveOrders": true,
        "documentTypes": [
          "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
        ]
      },
      "cachedAt": "2026-04-26T11:15:19.186Z",
      "originalIdentifier": "CZ12345678"
    }
  ]
}