Skip to main content

API

We designed our API to be as straightforward as possible.

To use the api you need an API token, you can find your API token in the dashboard, once you are logged in to the app.askfino.com.

Base URL​

The base URL for the APIs is: https://api.askfino.com/v0

Starting a VAT-ID verification​

Endpoint: https://api.askfino.com/v0/vatid/verifications

To verify a VAT ID you need to start a verification:

Authorization: Token {your-token}
POST https://api.askfino.com/v0/vatid/verifications

{
    "vat_id": "DE129274202",
    "external_id": "cp5TTADWiM" # Optional
}

The vat_id is the VAT ID you want to verify, the external_id is a unique id you can pass (maybe coming from your ERP).

You can also pass a country field. This field is optional if you prepend the country code to the VAT ID (DE129274202 instead of 129274202):

{
  "vat_id": "129274202",
  "country": "DE"
}

With Python

import requests

headers = {"Authorization" : "Token your-token"}

response = requests.post(
    "https://api.askfino.com/v0/vatid/verifications",
    headers=headers,
    json={"vat_id": "DE129274202"}
)

print(response.json())

The response might look like this one

[{
  "id": "01847578ab75ff2a74eb549db0d31449",
  "vat_id": "DE129274202",
  "external_id": "",
  "country": "DE",
  "status": "VERIFIED",
  "company_address": "",
  "company_name": "",
  "verification_number": "WAPIAAAAYR1eKzhU",
  "verified": true,
  "valid_format": true,
  "verified_at": "2022-11-14T09:29:14.851925Z",
  "created_at": "2022-11-14T09:29:13.333859Z"
}]

Get the result of a VAT-ID a verification​

Endpoint: https://api.askfino.com/v0/vatid/verifications/{verification-id}

When you create a verification the status returned can be PENDING.

In that case you can get the id and check the status at a later moment. We aim to perform all the verifications in less than 30 minutes (except during the downtime of the national services).

Authorization: Token {your-token}
GET https://api.askfino.com/v0/vatid/verifications/01847578ab75ff2a74eb549db0d31449

With Python


import requests

headers = {"Authorization" : "Token your-token"}

response = requests.get(
    "https://api.askfino.com/v0/vatid/verifications/01847578ab75ff2a74eb549db0d31449",
    headers=headers
)

print(response.json())

And here's the response

[{
  "id": "01847578ab75ff2a74eb549db0d31449",
  "vat_id": "DE129274202",
  "external_id": "",
  "country": "DE",
  "status": "VERIFIED",
  "company_address": "",
  "company_name": "",
  "verification_number": "WAPIAAAAYR1eKzhU",
  "verified": true,
  "valid_format": true,
  "verified_at": "2022-11-14T09:29:14.851925Z",
  "created_at": "2022-11-14T09:29:13.333859Z"
}]