API Reference

Create Partner Client and Revenue Claims

The Create Partner Client and Revenue Claims endpoint is used to send anonymised Partner Client data which liberis will use to synchronously create a Liberis Partner Client

Valid state Values

There are several statuses that the state property can be:

  • Duplicate : The associated data item has been deemed a duplicate
  • Conflict : The associated data item has been deemed a conflict with another data item in the original request
  • Failed : The associated data item has failed validation
  • Completed : The associated data item has passed validation and was saved to our data store

Failure Statuses

Any data item which has a state of Duplicate, Conflict or Failed will not be saved to our data stores.

Duplicate

When a state has a value of Duplicate, it indicates one of two conditions has been met:

  1. The associated data item is a perfect duplicate of another item in the original request, the first item in the original request was processed as unique and will provide its own state to indicate if Completed successfully and saved
  2. The associated data item is a duplicate of a record we have already seen and saved to our data store

The validation_errors property will contain a string error which describes which one of the above conditions was met.

Conflict

When a state has a value of Conflict, it indicates:

The associated data item is a duplicate of another data item in the original request by the unique key partner_client_id - however the data differs in the duplicates.

When this condition is met, those data items that are deemed duplicates by unique key partner_client_id will all have a state of Conflict as we are unable to determine which one is valid to process and save.

Failed

When a state has a value of Failed, it indicates:

The associated data item failed our validation routines and was not saved.

The validation_errors property will contain a string error which describes which one of the above conditions was met.

It is recommended a client logs this information as it could indicate the data in the data item contains malformed values and as such invalid.

A retry of the failed data item can be actioned once the validation_errors have been addressed.

Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!