REreacherapp
Contracts

List contracts

Changed on

Every contract the shop has generated, newest first. Each row carries the campaign and creator it was sent to, the full terms snapshot the document was rendered from, the signing status and both signature timestamps.

Filter by status (draft/sent/awaiting_brand/active/expired/voided/delivery_failed), by creator_id, by campaign_id, by signing_order, or by expiring_within_days to find active contracts about to lapse. status=expired and expiring_within_days are mutually exclusive — expiry is evaluated lazily against today's date, so asking for both is contradictory.

Cursor-paginated: pass the next_cursor from the previous response to get the next page. A null next_cursor means the last page. Single-shop only.

get/contracts

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/contracts
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

status'draft' | 'sent' | 'awaiting_brand' | 'active' | 'expired' | 'voided' | 'delivery_failed' nullable

Restrict to one signing status.

signing_order'brand_first' | 'creator_first' nullable

Restrict to one signing mode: brand_first (the brand signed before sending) or creator_first (the brand countersigns afterwards).

creator_idinteger nullable

Restrict to contracts sent to one creator.

campaign_idinteger nullable

Restrict to contracts generated for one campaign.

expiring_within_daysinteger nullable

Only active contracts expiring within this many days.

cursorstring nullable

Opaque cursor from next_cursor.

limitinteger

Rows per page (max 200).

Response

Successful Response

next_cursorstring nullable

Changes

  • 2a7ed9f8c407Revision changes
    • warning

      added the new gmv_and_live_gmv enum value to the ///// response property for the response status

    • warning

      added the new videos_gmv_and_live_gmv enum value to the ///// response property for the response status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

  • 34cc040be296Revision changes
    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status