# CAT Affiliates Documentation

> Documentation for CAT Affiliates

## Guides: documentation
- [Checkatrade API for Affiliates](https://developers.checkatrade.com/docs/getting-started.md)
  - [HMAC Authentication](https://developers.checkatrade.com/docs/hmac-authentication.md): A detailed guide and code examples for how to generate the correct signature.
  - [Understanding Trade Categories](https://developers.checkatrade.com/docs/understanding-trade-categories.md): Categories are how we funnel jobs to the right trade, getting this right is crucial.
  - [Submit a Job with Images](https://developers.checkatrade.com/docs/submit-job-with-images.md)
  - [Preferred Start Options](https://developers.checkatrade.com/docs/preferred-start-options.md)
- [Webhooks For Trades](https://developers.checkatrade.com/docs/webhooks-for-trades.md): Checkatrade's webhooks can be used by strategic accounts to push data into thier CRMs and other systems.

## API Reference: Affiliate Job API
- Webhook
  - [Endpoint to create a job from an authorised affiliate](https://developers.checkatrade.com/reference/postjobs.md): A public endpoint that is used to create affiliate jobs
  - [Create jobs with image attachments](https://developers.checkatrade.com/reference/postjobswithattachments.md): A public endpoint for affiliates to create jobs with image attachments
  - [Test job creation with attachments](https://developers.checkatrade.com/reference/postjobswithattachmentsverify.md): This is a test endpoint used to verify job request payloads with attachments, without creating any live data
  - [Endpoint to verify job creation would work from an authorised affiliate](https://developers.checkatrade.com/reference/postverifyjobs.md): A public endpoint that is used to verify affiliate job creation
- Address
  - [Retrieve address by ID](https://developers.checkatrade.com/reference/get_address-retrieve.md): Retrieve full structured address details by address ID (returned from search endpoint)
  - [Search for addresses](https://developers.checkatrade.com/reference/get_address-search.md): Search for addresses by query string (minimum 2 characters)
- Trades
  - [Search for trades](https://developers.checkatrade.com/reference/get_trades-search.md): Search for trades by postcode and category with pagination support

## API Reference: Checkatrade Lead Delivery Webhooks
- [Lead Delivery Webhooks](https://developers.checkatrade.com/reference/leads.md)
  - [Lead Webhook](https://developers.checkatrade.com/reference/post_leads.md)
- [Booking Delivery Webhooks](https://developers.checkatrade.com/reference/booking-delivery-webhooks.md): Booking delivery webhooks for strategic accounts to receive Checkatrade job bookings in two stages - job creation and job booking - with detailed payload information for CRM integration.

## API Reference: Checkatrade Payment Webhooks
- [Payment Webhooks](https://developers.checkatrade.com/reference/payment-webhooks.md): Our payments webhooks help you get Checkatrade Pay data stright into your accounting systems, speak to your account manager for more details
  - [Payment Requested](https://developers.checkatrade.com/reference/post_paymentrequested.md)
  - [Payment Paid](https://developers.checkatrade.com/reference/post_paymentpaid.md)
  - [Payment Cancelled](https://developers.checkatrade.com/reference/post_paymentcancelled.md)