window.pipedriveLeadboosterConfig = {base: '',companyId: 6339110,playbookId: 4475};

Likvido API Documentation

Welcome to our API documentation.
If you have any questions feel free to contact our CTO Lars
Holdgaard on [email protected]

Welcome to the Likvido API documentation!

We have two different "types" of API's:

  • API to interact with your own account. This is used when you have an account on Likvido and want to access your own data, add new invoices or generally work with your own data.
  • API for partners. This is used for white-label partners. Here you can actually manage a list of companies. The logic behind, is the same for partners as for companies with their own API key - the only difference is that a partner can make calls on behalf of the companies they manage


You can access the API at: (core API path)

You can find our current Swagger UI: (Swagger UI)

Understanding our domain


Everything we do revolves around Invoices. An invoice is a claim from a creditor to a debtor.

A creditor is a person or company that has a claim. A creditor can be anyone, companies and consumers.
If you access "your own data", you will be the creditor. Partners will have control over a list of creditors.

A debtor is a person or company that owes money to a creditor. A debtor can be anyone, companies and consumers. Debtors belong to a creditor, meaning we do not "merge" debtors and creditors, and see them as unique individuals.

When an invoice is created at Likvido, it will go through a couple of stages. The goal is to assign a campaign to the invoice.

The steps the invoice goes through are:

  1. Data validation to make sure the provided data is correct (typically ~24 hours)
  2. Create the first demand (typically instant)
  3. Assign the correct campaign (typically instant)
  4. Send out communication (typically instant, but up to ~24 hours depending on weekend/weekday and time of day)


All invoices are assigned to a campaign.

A campaign is a collection of actions and communication that Likvido will send to a debtor. A campaign can be anything from sending out a friendly "New invoice" e-mail, to a campaign which has the purpose of actually suing the debtor.

Our campaigns have a CampaignType. CampaignTypes are:

  • Invoicing: The Purpose is to just send our an invoice to the debtor
  • Reminders: The Purpose is to start a reminder flow, beginning with friendly reminders (without fees) evolving to sending two actual dunnings with fees
  • Debt collection: The Purpose is to start with a debt collection warning (inkassovarsel in Danish) and then starting an actual debt collection process

When you POST new invoices you can set the initialCampaignTypeRequest,meaning you can decide which flow you want us to begin.


We have described our models in Swagger. That means you can simply click "Model" in the responses to see what you are expected to POST or GET in return:

Required vs optional parameters

We have made sure that the required attributes on objects are marked with a [Required] field which results on the stars you can find on Swagger:

Getting your API key

If you want to interact with your own data, it is really easy. When logged in, in the top right, you can click "API nøgler". Here you can generate as many API keys as you want. You can also access it on this link.

If you are a partner then we need to create an API key for you manually. Please create an account and request us to give you a partner API key.

After this step, you should have a nice API key.

Check authentication & authorization

Whenever using our API, you need to use your API key. Simply add an HTTP header with "ApiKey" and your key.

To test if you are doing it right, you can use the Authentication endpoint. Here is an example with the ApiKey test, which will result in a 401 response.

curl -X GET "" -H "accept: application/json" -H "X-ApiKey: test"

If you're doing it right, you will get a status code 200 response back, and if not, a 401 unauthorized response.

Test vs. production

We currently do not offer a test environment for those of you who want to access their own data. If you need special access, please contact us and we can help you out.

For partners, we will always create two accounts: one for production and one for the test environment. That means you have two URL's as a partner: (test)

and (production)


Our enums are represented as strings in Swagger, however, some of them need further explanation.


InvoiceState: This is the current state of the Invoice. We have the following states:

  • 0: New: Everything is ready and we are about to send communication
  • 15: Invoice: Invoice is in the invoicing process
  • 1: Dunning Invoice is in the reminder’s process
  • 2: DebtCollection: Invoice is in the debt collection process
  • 3: Legal: we are now taking legal action
  • 4: Objection: Debtor had an objection - pending. We will reply
  • 5: Surveillance: In surveillance
  • 6: Installment: Installment plan is made
  • 7: Done: Case is finished
  • 8: PendingCreditor: Pending the creditor
  • 9: PendingCreation: We are pending and creating the demand
  • 16: PendingAcceptance: The creditor needs to accept the campaign we are starting
  • 10: Paused: The case is paused
  • 11: SmallCourt: The case is taken to court
  • 12: PendingData: We are validating the data
  • 13: PendingCampaign: We are picking the relevant campaign for the invoice
  • 14: DataInvalid: Data is invalid and we need new data to continue the case

InitialCampaignTypeRequest: This is the request for the type of campaign we should run first:

  • 1: DebtCollection: Starts a debt collection campaign
  • 3: Surveillance: Starts a surveillance campain
  • 5: Reminders: Starts a reminder campaign
  • 6: Invoice: Starts an invoicing campaign


CreditorType: This is the overall type of a creditor:

  • 0: Private: Consumer
  • 1: Company: Corporation / company which has a valid VAT-number

Any questions?

If you have any questions to our tech-stack or API please dont
hesitate to contact me on [email protected]
Also feel free to connect if you have any feedback.
You can see our full roadmap online.

“Feel free to send me an e-
mail if you have any
(technical) questions or want
to join our tech-slack

Lars Holdgaard

Co-founder & partner