Contracts

Get one contract

Changed on

One contract envelope: the campaign and creator it belongs to, the frozen terms the document was rendered from (deliverables, reward structure, usage rights, dates), the signing status, and brand_signed_at / creator_signed_at — null until that party signs. last_error carries the delivery failure reason when status is delivery_failed.

signing_order is brand_first when the brand signed before the contract was sent, or creator_first when the brand countersigns afterwards; a creator_first contract sits at awaiting_brand between the two signatures.

404 when the contract does not belong to this shop. Single-shop only.

get/contracts/{contract_id}

Request

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

Path parameters

contract_idstring uuid required

Contract id (UUID).

Response

Successful Response

idstring uuid required
batch_idstring uuid required
campaign_idinteger required
campaign_namestring required
creator_idinteger required
creator_namestring required
creator_handlestring required
contract_titlestring required
template_source'standard' required
status'draft' | 'sent' | 'awaiting_brand' | 'active' | 'expired' | 'voided' | 'delivery_failed' required
signing_order'brand_first' | 'creator_first'
brand_signed_atstring date-time nullable
creator_signed_atstring date-time nullable
effective_datestring date required
expiry_datestring date required
last_errorstring nullable

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

    • 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