Get Points Conversion Schedule

Retrieves the history of promised points conversion schedules of a customer for a single program or across all programs of the org.

This is a light API.

Using Multiple Identifiers

When dual eligibility is enabled in your organisation, the API allows you to send multiple identifiers while fetching details. The system automatically identifies which one is the primary identifier and retrieves the details accordingly. This removes the need for you to know or specify only the primary identifier. This is beneficial in a dual eligibility–enabled scenario, as the feature allows you to register multiple users with the same secondary identifiers.
When you submit multiple identifiers in a lookup request:

  • The service checks that dual eligibility is active.
  • It parses all submitted identifiers, for example email,mobile,externalId
  • It determines which identifier is configured as the primary key.
  • If one of the provided values matches the primary key, the API uses it for the lookup.
  • The API returns the single customer profile associated with the primary identifier.

You can enter multiple identifiers as comma-separated values using the identifierName and identifierValue query parameters. Ensure the order of the identifierName matches the identifierValue.

Note: If you provide only one identifier that is not the primary identifier, the system will return an error, 8015 - Customer not found for given identifiers.

Endpoint Example

https://eu.api.capillarytech.com/v2/customers/lookup/promisedPointsSchedule?source=INSTORE&identifierName=email,mobile,externalId&[email protected],915795008395,MPQSP100

Here,

  • [email protected] is the email
  • 915795008395 is the mobile number
  • MPQSP100 is the external ID

Important Note

WhenfetchDataForAllPrograms is truefetchDataForAllPrograms is false
programId is passedYou will still see promised points schedules of the customer across all programsYou will still see promised points schedules of that particular program.
programId is not passedYou will still see promised points schedules of the customer across all programsYou will still see promised points schedules of the default program.

Response Parameters

ParameterDatatypeDescription
entityIdlongUnique ID of the customer.
pointsTypeenumType of the points entry. Values: bill_regular, bill_promotions, line_item_regular, line_item_promotions, customer_promotions.
expiryTypeenumPoints expiry type - fixed or rolling.
triggerBasedPointsListobjShows the required condition to convert delayed accrual (promised points) to main points.

Error Code

Error CodeDescriptionReason
8015Customer not found for the given identifiersThe identifier provided is incorrect. When dual eligibility is enabled, if the primary identifier is missing from the input, the system returns the same error.
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!