> ## Documentation Index
> Fetch the complete documentation index at: https://help-loyalife.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for all 19 Loyalife API endpoints across 4 modules.

<Note>
  Several behaviours in Loyalife are **configurable per program** — including points-to-currency conversion rate, token lifetime, OTP expiry duration, OTP attempt limits, redemption thresholds, and rate limits. The values documented here reflect defaults or common configurations. For the exact values that apply to your integration, contact your **Xoxoday implementation contact** or reach out to [support@xoxoday.com](mailto:support@xoxoday.com).
</Note>

## Base URL

All API endpoints share the same base domain:

```
https://loyalife-api.xoxoday.in
```

This is the production base URL. A **staging environment** is also available — contact your Xoxoday implementation contact for the staging URL specific to your program.

## Authentication

Every endpoint (except `GenerateAuthToken` itself) requires a bearer token in the `Authorization` header:

```
Authorization: bearer {token}
```

See [Authentication](/concepts/authentication) for details on obtaining and refreshing tokens.

## Modules

| Module                   | Path Prefix                     | APIs |
| ------------------------ | ------------------------------- | ---- |
| **OAuth / Auth**         | `/lbms-ingress/oauth/`          | 1    |
| **Member (CPD)**         | `/lbms-ingress/member/`         | 9    |
| **Transaction (TXN)**    | `/lbms-ingress/transaction-lm/` | 6    |
| **Payment Gateway (PG)** | `/lbms-ingress/pg-lm/`          | 3    |

## Common Response Shape

All responses use a standard envelope. See [Response Format](/concepts/response-format).

```json theme={null}
{
  "results": {
    "IsSucessful": true,
    "ErrorCode": "000",
    "ExceptionMessage": "Success",
    "ReturnObject": { },
    "Count": 0
  }
}
```

## Common Parameters

| Parameter                     | Type    | Description                                                    |
| ----------------------------- | ------- | -------------------------------------------------------------- |
| `ProgramId` / `pintProgramId` | integer | Your loyalty program ID, issued at onboarding.                 |
| `RelationReference`           | string  | The member's unique identifier (e.g. `jane.doe@example.com`).  |
| `RelationType`                | integer | `4` = customer (used in almost all endpoints).                 |
| `TransactionCurrency`         | string  | `"DEFAULT"` unless your program uses a specific currency code. |