Skip to content
On this page

Leads

On this page, you can see all endpoints related to the Affiliate's leads

Dataset

FieldDescription
idThe unique identifier of the lead.
offer_idThe identifier of the associated offer.
referral_idThe referral code.
tracking_numberThe shipping tracking number.
statusThe current status of the lead, it can be: lead, confirmed, delivered,return, call_later, call_later_scheduled, no_reply, cancelled, wrong, expired, out_of_stock, shipped, duplicated
country_iso_codeThe ISO country code 2.
noteThe lead's comment.
commissionThe commission (payout).
currencyThe commission's currency.
created_atThe lead creation datetime.
updated_atThe lead modification datetime.
subidThe ID used for tracking.
subid2The second ID used for tracking.

Get All leads

Retrieve a list of all leads.

Endpoint

/affiliate/leads
1

Method GET

Parameters

None.

Response

json
{
    "status": "success",
    "data": [
        {
            "id": "...",
            "offer_id": "...",
            "referral_id": "...",
            "tracking_number": "...",
            "status": "...",
            "country_iso_code": "...",
            "note": "...",
            "created_at": "...",
            "updated_at": "...",
            "subid": "...",
            "subid2": "...",
            "commission": "",
            "currency": ""
        },
        ...
    ],
    "meta": {
        "pagination": {...}
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

Show lead

Retrieve a lead.

Endpoint

/affiliate/leads/{id}
1

Method GET

Parameters

NameTypeDescriptionRequired
idstringThe unique identifier of the lead to retrieve.Yes

Response

json
{
  "status": "success",
  "data": {
    "id": "...",
    "offer_id": "...",
    "referral_id": "...",
    "tracking_number": "...",
    "status": "...",
    "country_iso_code": "...",
    "note": "...",
    "created_at": "...",
    "updated_at": "...",
    "subid": "...",
    "subid2": "...",
    "commission": "",
    "currency": ""
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Create lead

Create one lead.

Endpoint

/affiliate/leads
1

Method POST

Parameters

NameTypeDescriptionRequired
referral_idstringThe referral idYes
namestringThe customer's nameYes
phonestringThe customer's phone numberYes
addressstringThe customer's addressYes
subidstringThe ID used for trackingNo
subid2stringThe second ID used for trackingNo
citystringThe customer's cityNo
countrystringThe offer country ISO code 2No
zip CodestringThe customer's zip codeNo
quantityintThe quantity orderedNo
notestringThe lead's comment.No

Response

201 Created

json
{
  "status": "success",
  "data": {
    "id": "...",
    "offer_id": "...",
    "referral_id": "...",
    "tracking_number": "...",
    "status": "...",
    "country_iso_code": "...",
    "note": "...",
    "created_at": "...",
    "updated_at": "...",
    "subid": "...",
    "subid2": "...",
    "commission": "",
    "currency": ""
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Get notified on a lead status update

To retrieve the lead status update go to your account settings and put your webhook callback URL, if something went wrong, do not hesitate to contact us at [email protected]

Json format

json
{
  "lead_id": "...",
  "status": "...",
  "subid": "...",
  "subid2": "..."
}
1
2
3
4
5
6