--- updatedAt: 2026-09-10T20:52:34.000Z agentTools: projectIndex: https://developers.deliverect.com/v3.0-ordering-experience/llms.txt --- # Get Loyalty Customer ## Purpose This endpoint returns customer information by email and phone number from the loyalty provider system. {`

If a location or channel link ID isn't known, the accountId can be used instead: /loyalty/account/{accountId}/configuration

`} # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "loyalty-api", "version": "1.0" }, "servers": [ { "url": "https://api.staging.deliverect.com" } ], "security": [ { "oauth2ClientCredentials": [] } ], "components": { "securitySchemes": { "oauth2ClientCredentials": { "type": "oauth2", "description": "Obtain an access token using the partner client ID and client secret. Send the returned token with each API request in the Authorization header as a Bearer token.", "flows": { "clientCredentials": { "tokenUrl": "/oauth/token", "scopes": {} } } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true, "oauth-options": { "useInsecureClientAuthentication": true } }, "x-readme-fauxas": true, "paths": { "/loyalty/{channelLinkId}/customer": { "get": { "summary": "Get Loyalty Customer", "description": "", "operationId": "loyalty-channel-get-customer", "parameters": [ { "name": "channelLinkId", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "email", "in": "query", "description": "email of the end customer", "schema": { "type": "string" } }, { "name": "phoneNumber", "in": "query", "description": "phone number of the end customer in E164 format", "schema": { "type": "string" } }, { "in": "query", "name": "providerId", "schema": { "type": "string" }, "description": "The customer's unique identifier within the loyalty provider's system, QR codes can also be passed via this parameter where supported on the Loyalty platform" } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "without tier": { "value": { "firstName": "John", "lastName": "Doe", "email": "john.doe@email.com", "phoneNumber": "+32411222333", "dateOfBirth": "1970-01-01T00:00:00.000000+00:00", "lifetimePointsBalance": 0, "status": "activation_pending", "tier": null, "providerId": "376483" } }, "with tier": { "value": { "providerId": "83885", "firstName": "John", "lastName": "Doe", "email": "john.doe@email.com", "phoneNumber": "+32411222333", "dateOfBirth": "1970-01-01T00:00:00.000000+00:00", "lifetimePointsBalance": 0, "status": "active", "tier": { "name": "Bronze", "description": "This is a bronze tier", "media": { "url": "https://deliverect.com/image.png", "mediaType": "image", "requirements": { "minLifetimePoints": 0, "maxLifetimePoints": 1000 } } } } } }, "schema": { "oneOf": [ { "title": "without tier", "type": "object", "properties": { "firstName": { "type": "string", "example": "John" }, "lastName": { "type": "string", "example": "Doe" }, "email": { "type": "string", "example": "john.doe@email.com" }, "phoneNumber": { "type": "string", "example": "+32411222333" }, "dateOfBirth": { "type": "string", "example": "1970-01-01T00:00:00.000000+00:00" }, "lifetimePointsBalance": { "type": "integer", "example": 0, "default": 0 }, "status": { "type": "string", "example": "activation_pending" }, "tier": {}, "providerId": { "type": "string" } }, "required": [ "providerId" ] }, { "title": "with tier", "type": "object", "properties": { "firstName": { "type": "string", "example": "John" }, "lastName": { "type": "string", "example": "Doe" }, "email": { "type": "string", "example": "john.doe@email.com" }, "phoneNumber": { "type": "string", "example": "+32411222333" }, "dateOfBirth": { "type": "string", "example": "1970-01-01T00:00:00.000000+00:00" }, "lifetimePointsBalance": { "type": "integer", "example": 0, "default": 0 }, "status": { "type": "string", "example": "active" }, "tier": { "type": "object", "properties": { "name": { "type": "string", "example": "Bronze" }, "description": { "type": "string", "example": "This is a bronze tier" }, "media": { "type": "object", "properties": { "url": { "type": "string", "example": "https://deliverect.com/image.png" }, "mediaType": { "type": "string", "example": "image" }, "requirements": { "type": "object", "properties": { "minLifetimePoints": { "type": "integer", "example": 0, "default": 0 }, "maxLifetimePoints": { "type": "integer", "example": 1000, "default": 0 } } } } } } }, "providerId": { "type": "string" } }, "required": [ "providerId" ] } ] } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": \"no active loyalty profile found\",\n \"http_code\": 400,\n \"description\": \"no active loyalty profile found\"\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "no active loyalty profile found" }, "http_code": { "type": "integer", "example": 400, "default": 0 }, "description": { "type": "string", "example": "no active loyalty profile found" } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": \"loyalty customer not found\",\n \"http_code\": 404,\n \"description\": \"loyalty customer not found\"\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "loyalty customer not found" }, "http_code": { "type": "integer", "example": 404, "default": 0 }, "description": { "type": "string", "example": "loyalty customer not found" } } } } } } } } } } } ```