--- updatedAt: 2026-04-23T12:53:11.000Z agentTools: projectIndex: https://developers.themarketer.com/llms.txt --- # Loyalty Info You can retrieve all the Loyalty program information for each of your customers by using the Loyalty API. This information can be used on your website, for example you can display it in the customer’s account. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "theMarketer API", "version": "1.0.0", "description": "" }, "servers": [ { "url": "https://t.themarketer.com" } ], "paths": { "/api/v1/loyalty_info": { "parameters": [], "get": { "summary": "Loyalty Info", "tags": [], "parameters": [ { "name": "k", "in": "query", "required": true, "deprecated": false, "schema": { "type": "string" }, "example": "REST_KEY" }, { "name": "u", "in": "query", "required": true, "deprecated": false, "schema": { "type": "string" }, "example": "CUSTOMER_ID" }, { "name": "email", "in": "query", "required": true, "deprecated": false, "schema": { "type": "string" }, "example": "email@example.com" } ], "responses": { "200": { "description": "200 Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "stats": { "type": "object", "properties": { "current_tier": { "type": "string", "example": "Beginner", "description": "Beginner" }, "current_tier_points_start": { "type": "integer", "example": "1000", "description": "1000" }, "current_tier_points_end": { "type": "integer", "example": "2999", "description": "2999" }, "next_tier": { "type": "string", "example": "Apprentice", "description": "Apprentice" }, "current_points": { "type": "integer", "example": "1400", "description": "1400" }, "redeemed_points": { "type": "integer", "example": "100", "description": "100" }, "points_about_to_expire": { "type": "integer", "example": "500", "description": "500" }, "joined_on": { "type": "string", "example": "23.06.2025", "description": "23.06.2025" }, "last_update": { "type": "string", "example": "15.05.2025", "description": "15.05.2025" }, "membership": { "type": "boolean", "example": "true", "description": "true" } } }, "points_history": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-07-18 11:19:18", "description": "2025-07-18 11:19:18" }, "points": { "type": "integer", "example": "200", "description": "200" }, "event_name": { "type": "string", "example": "Placed an order", "description": "Placed an order" }, "event_type": { "type": "string", "example": "earn", "description": "earn" } } } }, "tier_evolution": { "type": "object", "properties": { "tiers": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "Rookie", "description": "Rookie" }, "value": { "type": "integer", "example": "0", "description": "0" } } } }, "days": { "type": "array", "items": { "type": "string", "example": "23.06.2025", "description": "23.06.2025" } }, "tier": { "type": "array", "items": { "type": "integer", "example": "0", "description": "0" } } } }, "points_evolution": { "type": "object", "properties": { "days": { "type": "array", "items": { "type": "string", "example": "23.06.2025", "description": "23.06.2025" } }, "points": { "type": "array", "items": { "type": "integer", "example": "200", "description": "200" } } } }, "rewards_history": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "example": "2025-07-18 11:19:18", "description": "2025-07-18 11:19:18" }, "points": { "type": "integer", "example": "0", "description": "0" }, "title": { "type": "string", "example": "10% discount", "description": "10% discount" }, "discount_code": { "type": "string", "example": "MKTR1234", "description": "MKTR1234" }, "discount_code_expiration_date": { "type": "string", "example": "2025-07-18", "description": "2025-07-18" }, "used": { "type": "boolean", "example": "true", "description": "true" } } } } } }, "example": { "stats": { "current_tier": "Beginner", "current_tier_points_start": 1000, "current_tier_points_end": 2999, "next_tier": "Apprentice", "current_points": 1400, "redeemed_points": 0, "points_about_to_expire": 0, "joined_on": "23.06.2025", "last_update": "18.07.2025", "membership": true }, "points_history": [ { "date": "2025-07-18 11:19:18", "points": 200, "event_name": "Placed an order", "event_type": "earn" }, { "date": "2025-06-26 01:00:02", "points": 100, "event_name": "Reached order value", "event_type": "earn" }, { "date": "2025-06-26 01:00:02", "points": 200, "event_name": "Placed an order", "event_type": "earn" }, { "date": "2025-06-24 09:36:53", "points": 100, "event_name": "Reached order value", "event_type": "earn" }, { "date": "2025-06-24 09:36:53", "points": 200, "event_name": "Placed an order", "event_type": "earn" }, { "date": "2025-06-23 17:46:45", "points": 300, "event_name": "Cancelled their order", "event_type": "spend" }, { "date": "2025-06-23 17:45:35", "points": 100, "event_name": "Reached order value", "event_type": "earn" }, { "date": "2025-06-23 17:45:35", "points": 200, "event_name": "Placed an order", "event_type": "earn" }, { "date": "2025-06-23 17:17:38", "points": 600, "event_name": "Cancelled their order", "event_type": "spend" }, { "date": "2025-06-23 17:09:21", "points": 100, "event_name": "Reached order value", "event_type": "earn" } ], "tier_evolution": { "tiers": [ { "name": "Rookie", "value": 0 }, { "name": "Beginner", "value": 1 }, { "name": "Apprentice", "value": 2 } ], "days": [ "23.06.2025" ], "tier": [ 0 ] }, "points_evolution": { "days": [ "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "23.06.2025", "24.06.2025", "24.06.2025", "26.06.2025", "26.06.2025", "18.07.2025" ], "points": [ 0, 200, 400, 600, 900, 1000, 1200, 1300, 700, 900, 1000, 700, 900, 1000, 1200, 1300, 1500 ] }, "rewards_history": [ { "date": "2025-07-25 12:30:02", "points": 0, "title": "10 Lei Discount", "discount_code": "MKTR-35UZVO1B7V", "discount_code_expire_date": null, "used": false } ] } } } }, "400": { "description": "400 Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Customer ID not provided / REST Key not provided", "description": "Customer ID not provided / REST Key not provided" } } }, "example": { "message": "Customer ID not provided." } } } }, "401": { "description": "401 Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid REST Key", "description": "Invalid REST Key" } } }, "example": { "message": "Invalid REST Key." } } } }, "404": { "description": "404 Not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Customer not found", "description": "Customer not found" } } }, "example": { "message": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID" } } } }, "405": { "description": "405 Method not allowed", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "The POST method is not supported for this route. Supported methods: GET, HEAD.", "description": "The POST method is not supported for this route. Supported methods: GET, HEAD." } } }, "example": { "message": "The POST method is not supported for this route. Supported methods: GET, HEAD." } } } } } } } } } ```