# Leat API Documentation > The REST API behind the Leat loyalty platform: contacts, credits, > rewards, giftcards, prepaid, promotions, orders and the webhooks that report > on them. Every page listed here is Markdown; drop the .md for the human > version. Requests are authenticated with a Personal Access Token — > `Authorization: Bearer {{ access_token }}` — and endpoints live > under `https://api.leat.com/api/v3/oauth/clients`. ## Getting started - [ChangeLog](https://docs.leat.com/changelog.md): Every change to the API lands here, newest first. - [Introduction](https://docs.leat.com/v3.md): If you need help please send an email to partners@leat.com. - [AI and agents](https://docs.leat.com/v3/ai-and-agents.md): Every page on this site is also published as Markdown, so a coding assistant can read the reference the same way you do. - [Authentication](https://docs.leat.com/v3/authentication.md): On our API routes, the use of Personal Access Tokens is now the preferred method of authentication. - [Error handling](https://docs.leat.com/v3/error-handling.md): Requests that result in an error always have the same response syntax: - [Register API](https://docs.leat.com/v3/register-api.md): We're in the process of discontinuing our Register API in favour of a single easy API version. - [Testing](https://docs.leat.com/v3/testing.md): Testing your integration can be done simply using our Production environment. ## Tutorials - [Kiosk](https://docs.leat.com/v3/tutorials/kiosk.md): This guide covers how to build a loyalty integration for self-ordering kiosk software. - [Migrate to V3](https://docs.leat.com/v3/tutorials/migrate-to-v3.md): V3 of the public API is now live. - [Order at Table](https://docs.leat.com/v3/tutorials/order-at-table.md): This guide covers how to build a loyalty integration for Order at Table systems. - [Point of Sale](https://docs.leat.com/v3/tutorials/pos.md): This is a guide on how to build an integration for POS software. ## API reference - [Automations](https://docs.leat.com/v3/oauth/automations.md): Automations are a key feature that help our clients automate a variety of tasks. - [Bookings](https://docs.leat.com/v3/oauth/bookings.md): Bookings are replicas of the bookings made in your own reservation system. - [Brand Kit](https://docs.leat.com/v3/oauth/brand-kit.md): A Brand kit expresses the identity of your company. - [Categories](https://docs.leat.com/v3/oauth/categories.md): Categories are entities that group certain Products. - [Collectable Rewards](https://docs.leat.com/v3/oauth/collectable-rewards.md): Collectable Rewards represent Physical Rewards that have been claimed but are yet to be collected. - [Contact Attributes](https://docs.leat.com/v3/oauth/contact-attributes.md): Piggy provides a number of standard Contact Attributes, such as first and last name, birthdate, email address and phone number. - [Contact Identifiers](https://docs.leat.com/v3/oauth/contact-identifiers.md): Mostly, Contacts are identified by their email address. - [Contact Session Tokens](https://docs.leat.com/v3/oauth/contact-session-tokens.md): Find a Contact's Session Token to identify and validate them. - [Contact Subscriptions](https://docs.leat.com/v3/oauth/contact-subscriptions.md): Contact Subscriptions are the links between Subscription Types and Contacts. - [Contact Verification](https://docs.leat.com/v3/oauth/contact-verification.md): Business owners use the Piggy system to send out a verification email to their Contacts whenever a Contact wants to login to the business owner's Contacts Portal. - [Contacts](https://docs.leat.com/v3/oauth/contacts.md): Contacts are the end-users of Clients. - [Contacts Portal](https://docs.leat.com/v3/oauth/contacts-portal.md): Each Leat Client has their own Contacts Portal, which is basically a web app which they can use to serve their Contacts. - [Credit Receptions](https://docs.leat.com/v3/oauth/credit-receptions.md): Credit Receptions are instances of loyalty points transactions in the system. - [Custom Attribute Groups](https://docs.leat.com/v3/oauth/custom-attribute-groups.md): Retrieve all Custom Attribute Groups for a specific entity. - [Custom Attributes](https://docs.leat.com/v3/oauth/custom-attributes.md): Custom Attributes are flexible, tailored attributes that allow you to extend the entities in the Piggy system. - [Forms](https://docs.leat.com/v3/oauth/forms.md): Forms are a simple yet powerful tool for collecting valuable information about your customers or employees. - [Giftcard Programs](https://docs.leat.com/v3/oauth/giftcard-programs.md): The Piggy Giftcards system has two types of giftcards: physical and digital giftcards, which are tied to a specific Giftcard Program. - [Giftcard Transactions](https://docs.leat.com/v3/oauth/giftcard-transactions.md): Our software only allows non-reincrementable Giftcards for transaction creation through OAuth, due to security reasons. - [Giftcards](https://docs.leat.com/v3/oauth/giftcards.md): Our Giftcards system has two types of Giftcards: physical and digital Giftcards. - [Loyalty Program](https://docs.leat.com/v3/oauth/loyalty-program.md): Contacts save credits at Loyalty Programs. - [Loyalty Tokens](https://docs.leat.com/v3/oauth/loyalty-tokens.md): A Loyalty Token is, simply put, a Credit Reception not yet assigned to a specific Contact. - [Loyalty Transaction Attributes](https://docs.leat.com/v3/oauth/loyalty-transaction-attributes.md): Loyalty Transaction Attributes are Custom Attributes that you can link to your Loyalty Transactions, tailored to your specific needs. - [Loyalty Transactions](https://docs.leat.com/v3/oauth/loyalty-transactions.md): Loyalty Transaction is the umbrella term for both Credit Receptions and Reward Receptions, representing all the changes to a Credit Balance. - [Order Returns](https://docs.leat.com/v3/oauth/order-returns.md): Order Returns represent reversals of previously created Orders in the Leat system. - [Orders](https://docs.leat.com/v3/oauth/orders.md): Orders are replicas of the orders generated by external software (e.g. web shops, ordering apps, POS systems, kiosks et cetera), to be used by Leat as the driving force behind our Loyalty, Marketing,… - [Perks](https://docs.leat.com/v3/oauth/perks.md): Perks are benefits associated with different Tiers in our system, designed to enhance customer engagement and loyalty. - [Portal Sessions](https://docs.leat.com/v3/oauth/portal-sessions.md): A Portal Session is created for a Contact. - [POS Transactions](https://docs.leat.com/v3/oauth/pos-transactions.md): For the completeness of data in the Piggy system, Piggy Clients may choose to create `POS Transactions` and link these to `Credit Receptions`. - [Prepaid Transactions](https://docs.leat.com/v3/oauth/prepaid-transactions.md): Create contact-specific Prepaid Balances to settle refunds or reward extra credits. - [Products](https://docs.leat.com/v3/oauth/products.md): Products are used for the Line Items of Orders. - [Promotion Attributes](https://docs.leat.com/v3/oauth/promotion-attributes.md): Promotion Attributes are customizable fields that you can use to add unique characteristics to your Promotions. - [Promotions](https://docs.leat.com/v3/oauth/promotions.md): Vouchers are directly connected to specific Promotions, just like Giftcards are connected to Giftcard Programs. - [Referrals](https://docs.leat.com/v3/oauth/referrals.md): Get insights in your referral program and retrieve all Referrals made by your Contact. - [Reward Receptions](https://docs.leat.com/v3/oauth/reward-receptions.md): Reward Receptions allow end-users to redeem Rewards using the credits they've accumulated in a Loyalty Program. - [Rewards](https://docs.leat.com/v3/oauth/rewards.md): Once end-users have saved up enough credits at a certain Loyalty Program, they can use those credits to redeem Rewards. - [Shift Teams](https://docs.leat.com/v3/oauth/shift-teams.md): Shift Teams are replicas of the teams in your own scheduling system: the group a Shift is worked by. - [Shift Types](https://docs.leat.com/v3/oauth/shift-types.md): Shift Types are replicas of the shift kinds in your own scheduling system, so the Shifts of one kind can be grouped and reported on together. - [Shifts](https://docs.leat.com/v3/oauth/shifts.md): Shifts are replicas of the shifts planned in your own scheduling system. - [Shops](https://docs.leat.com/v3/oauth/shops.md): Shops play a central role in most transactions within our system. - [Subscription Types](https://docs.leat.com/v3/oauth/subscription-types.md): Subscription Types are ways of setting up different categories for your communication. - [Tiers](https://docs.leat.com/v3/oauth/tiers.md): You can now offer your Contacts an extra bonus by using Tiers. - [Units](https://docs.leat.com/v3/oauth/units.md): Units can be seen as the input values for Credit Receptions. - [Visits](https://docs.leat.com/v3/oauth/visits.md): Visits are replicas of the visits registered in your own system. - [Vouchers](https://docs.leat.com/v3/oauth/vouchers.md): Retrieve a paginated list of all Vouchers for an Account, with the option to filter by Promotion, Contact, Voucher status, and more. - [Webhooks](https://docs.leat.com/v3/oauth/webhooks.md): For a number of events, you can subscribe to Webhooks to receive event data.