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.

Resource Information

URIcustomer
HTTP MethodGET
Pagination supported?NA
Rate limitNA
Batch supportNA

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

Response ParameterDescription
entityIdThe unique identifier for the entity.
entityTypeThe type of entity (in this case, "CUSTOMER").
promisedPointsScheduleListA list of schedules detailing points that are promised.
promisedPointsScheduleList.pointsThe number of points in the schedule.
promisedPointsScheduleList.redeemableFromThe date from which the points become redeemable.
promisedPointsScheduleList.programIdThe identifier for the program associated with the points.
promisedPointsScheduleList.pointsTypeThe type of points (e.g., "line_item_promotions", "bill_regular", etc.).
triggerBasedPointsListA list of points based on specific triggers
warningsA list of warnings related to the entity

Example

when fetchDataForAllPrograms=false and fetchEarliestExpiryOnly=false

http://{{URL}}/v2/customers/lookup/promisedPointsSchedule?programId=2199&entityType=CUSTOMER&fetchDataForAllPrograms=false&identifierName=mobile&identifierValue=917752198768&source=INSTORE

{
    "entityId": 374844123,
    "entityType": "CUSTOMER",
    "promisedPointsScheduleList": [
        {
            "points": 390.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "line_item_promotions"
        },
        {
            "points": 130.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "bill_regular"
        },
        {
            "points": 130.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "bill_promotions"
        },
        {
            "points": 390.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "line_item_regular"
        }
    ],
    "triggerBasedPointsList": [],
    "warnings": []
}

when fetchDataForAllPrograms=true

http://{{URL}}/v2/customers/lookup/promisedPointsSchedule?programId=1933&startDate=2022-04-01&endDate=2122-04-09&entityType=CUSTOMER&fetchDataForAllPrograms=true&identifierName=mobile&identifierValue=917752198768&source=INSTORE

{
    "entityId": 374844123,
    "entityType": "CUSTOMER",
    "promisedPointsScheduleList": [
        {
            "points": 390.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "line_item_promotions"
        },
        {
            "points": 300.00,
            "redeemableFrom": "2022-04-08",
            "programId": 1933,
            "pointsType": "line_item_promotions"
        },
        {
            "points": 130.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "bill_regular"
        },
        {
            "points": 130.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "bill_promotions"
        },
        {
            "points": 180.000,
            "redeemableFrom": "2022-04-09",
            "programId": 2199,
            "pointsType": "line_item_promotions"
        },
        {
            "points": 100.00,
            "redeemableFrom": "2022-04-08",
            "programId": 1933,
            "pointsType": "bill_regular"
        },
        {
            "points": 60.000,
            "redeemableFrom": "2022-04-09",
            "programId": 2199,
            "pointsType": "bill_regular"
        },
        {
            "points": 180.000,
            "redeemableFrom": "2022-04-09",
            "programId": 2199,
            "pointsType": "line_item_regular"
        },
        {
            "points": 390.000,
            "redeemableFrom": "2022-04-10",
            "programId": 2199,
            "pointsType": "line_item_regular"
        },
        {
            "points": 60.000,
            "redeemableFrom": "2022-04-09",
            "programId": 2199,
            "pointsType": "bill_promotions"
        },
        {
            "points": 100.00,
            "redeemableFrom": "2022-04-08",
            "programId": 1933,
            "pointsType": "bill_promotions"
        }
    ],
    "triggerBasedPointsList": [],
    "warnings": []
}

Response for trigger-based points

{
    "entityId": 342249069,
    "entityType": "CUSTOMER",
    "promisedPointsScheduleList": [],
    "triggerBasedPointsList": [
        {
            "points": 300.000,
            "programId": 890,
            "pointsType": "line_item_promotions"
        }
    ],
    "warnings": []
}

API specific error code

Error CodeDescriptionReason
8015Customer not found for the given identifierscustomer id is invalid or unsupported
885Invalid program id passedprogram Id is invalid or unsupported
1632group id/externalId/primary userId passed is not validInvalid group id/externalid/primary userid
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!