Affiliates
Find All
/v1/networks/affiliates
Paging
This endpoint supports paging. Refer to our User Guide for usage.
Filters
This endpoint supports basic filtering. Refer to API filters page for usage.
Value | Description |
---|---|
time_created | Filter based on the creation time |
time_saved | Filter based on the last update time |
account_status | Filter based on the account status |
Relationships
This endpoint supports the following additional relationships. Refer to our User Guide for usage.
This endpoint supports additional relationships. You can ask for them using the relationship
query parameter. Multiple relationships can be supplied repeating the relationship
query parameter.
Value | Description |
---|---|
reporting | Includes reporting information |
billing | Includes billing and invoicing information |
affiliate_payment_balance | Includes the affiliate payment balance from outstanding invoices |
coupon_codes | Includes a list of the affiliate’s coupon codes |
users | Includes the list of affiliate users |
audits | Includes the revision history of changes made to the affiliate |
visibility | Includes lists of visible, hidden and rejected offers |
signup | Includes the affiliate’s signup info |
api | Includes the affiliate’s API keys |
traffic_source | Includes the affiliate’s traffic sources |
referral_link | Includes the affiliate’s referral link |
referrer | Include the affiliate’s referrer, if any |
referral | Includes the affiliate’s referral info |
supply_partner | Includes the affiliate’s EverXchange settings |
Request Example
cURL
curl --request GET 'https://api.eflow.team/v1/networks/affiliates' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
"affiliates": [
{
"network_affiliate_id": 1,
"network_id": 346,
"name": "Google",
"account_status": "active",
"network_employee_id": 6,
"internal_notes": "",
"has_notifications": true,
"network_traffic_source_id": 0,
"account_executive_id": 0,
"adress_id": 0,
"default_currency_id": "USD",
"is_contact_address_enabled": false,
"enable_media_cost_tracking_links": true,
"time_created": 1554517251,
"time_saved": 1560453624,
"relationship": {
"labels": {
"total": 1,
"entries": [
"Direct"
]
},
"account_manager": {
"first_name": "Bob",
"last_name": "Smith",
"email": "my.everflow@gmail.com",
"work_phone": "",
"cell_phone": "",
"instant_messaging_id": 1,
"instant_messaging_identifier": "peter_mobaff"
},
"encoded_value": "28KL6"
},
"referrer_id": 0
}
],
"paging": {
"page": 1,
"page_size": 50,
"total_count": 1
}
}
Find By ID
/v1/networks/affiliates/:affiliateId
Relationships
This endpoint supports the following additional relationships. Refer to our User Guide for usage.
This endpoint supports additional relationships. You can ask for them using the relationship
query parameter. Multiple relationships can be supplied repeating the relationship
query parameter.
Value | Description |
---|---|
reporting | Includes reporting informations |
billing | Includes billing and invoicing informations |
affiliate_payment_balance | Includes the affiliate payment balance from outstanding invoices |
coupon_codes | Includes a list of the affiliate’s coupon codes |
users | Includes the list of affiliate users |
audits | Includes the revision history of changes made to the affiliate |
visibility | Includes lists of visible, hidden and rejected offers |
signup | Includes the affiliate’s signup info |
api | Includes the affiliate’s API keys |
traffic_source | Includes the affiliate’s traffic sources |
referral_link | Includes the affiliate’s referral link |
referrer | Include the affiliate’s referer, if any |
referral | Includes the affiliate’s referral info |
supply_partner | Includes the affiliate’s EverXchange settings |
Path Parameters
Parameter | Description |
---|---|
affiliateId | The ID of the affiliate you want to fetch |
Request Example
cURL
curl --request GET 'https://api.eflow.team/v1/networks/affiliates/1' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
"network_affiliate_id": 1,
"network_id": 346,
"name": "Google",
"account_status": "active",
"network_employee_id": 6,
"internal_notes": "",
"has_notifications": true,
"network_traffic_source_id": 0,
"account_executive_id": 0,
"adress_id": 0,
"default_currency_id": "USD",
"is_contact_address_enabled": false,
"enable_media_cost_tracking_links": true,
"time_created": 1554517251,
"time_saved": 1560453624,
"relationship": {
"labels": {
"total": 1,
"entries": [
"Direct"
]
},
"account_manager": {
"first_name": "Bob",
"last_name": "Smith",
"email": "my.everflow@gmail.com",
"work_phone": "",
"cell_phone": "",
"instant_messaging_id": 1,
"instant_messaging_identifier": "peter_mobaff"
},
"encoded_value": "28KL6"
},
"referrer_id": 0
}
Find (Advanced)
/v1/networks/affiliatestable
Paging
This endpoint supports paging. Refer to our User Guide for usage.
Body Params
This endpoint supports query filters.
The name of the field used for search. Only “name” is supported.
The value to search.
Filter affiliates based on a specific account status. Supported values are: “active”, “inactive”, “pending” and “suspended”.
Only include affiliates managed by the specified account managers.
Only include affiliates managed by the specified account executives.
Filter affiliates based on a specific billing frequency. Supported values are: “weekly”, “bimonthly”, “monthly”, “two_months”, “quarterly”, “manual” and “other”.
Filter affiliates based on a specific payment type. Supported values are: “none”, “paypal”, “check”, “wire”, “direct_deposit”, “tipalti”, “paxum”, “veem”, “payoneer”, “bitcoin”, “webmoney”, “capitalist”, “gift_card”, “masspay” and “skrill”.
Only include affiliates matching the specified labels.
Only include affiliates that ran traffic in the last amount of hours specified.
Only include affiliates running traffic on the specified tracking domains.
Request Example
cURL
curl --request POST 'https://api.eflow.team/v1/networks/affiliatestable' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'Content-Type: application/json' \
--data '<INSERT PAYLOAD>'
Response
{
"affiliates": [
{
"network_affiliate_id": 1,
"network_id": 63,
"name": "Google",
"account_status": "active",
"account_manager_id": 9,
"account_manager_name": "Bob Smith",
"account_executive_id": 15,
"account_executive_name": "John Doe",
"today_revenue": "$7993.00",
"user": null,
"time_created": 1515810377,
"time_saved": 1584729057,
"labels": [
"w9"
],
"balance": 0,
"last_login": 1567529624,
"global_tracking_domain_url": ""
}
],
"paging": {
"page": 1,
"page_size": 50,
"total_count": 1
}
}
Create
/v1/networks/affiliates
Body Params
The name of the affiliate
The affiliate’s account status. Can either be active
or inactive
.
The employee id of the affiliate’s account manager.
Internal notes for network usage
The affiliate’s default currency. Can be found using the metadata API
Whether or not you want to allow affiliate to pass and override cost in their tracking links. Defaults to false.
The id of the affiliate that referred the new affiliate. Defaults to 0 (none).
Whether or not you want to include a contact address for this affiliate. Defaults to false.
The ID of the Affiliate Tier.
The affiliate’s contact address information. Only required if “is_contact_address_enabled” is set to true.
The address first line
The address second line
The city name
The region code. Can be found using the metadata API.
The country code. Can be found using the metadata API.
The ZIP or Postal code.
A list of affiliate users to be created along with the affiliate entity.
The affiliate user’s first name
The affiliate user’s last name
The affiliate user’s email. Must be unique among all affiliate users. Is used to log in the platform.
The affiliate user’s account status. Can be either active
or inactive
.
The affiliate user’s title.
The affiliate user’s work phone number.
The affiliate user’s cell phone number.
The id of an instant messaging platform. Allows you to save their identifier for further reference.
The affiliate user’s instant messaging identifier, if instant_messaging_id was different than 0.
The affiliate user’s language id. This is limited to the value 1
(English).
The affiliate user’s timezone id. Can be found using the metadata API.
The affiliate user’s currency id. Can be found using the metadata API
The affiliate user’s login password. If left empty, the affiliate will be sent an email asking to set their password.
The affiliate’s billing information.
The affiliate’s invoicing frequency. Can be one of the following values: weekly
, bimonthly
, monthly
, two_months
, quarterly
, manual
or other
.
The affiliate’s payment type. Can be one of the following values: none
, paypal
, check
, wire
, direct_deposit
, tipalti
, payum
, veem
, payoneer
, bitcoin
, webmoney
, capitalist
, gift_card
, masspay
or skrill
The affiliate’s tax id.
Configures automatic invoice creations for the affiliate. Defaults to “false”.
Configures automatic invoice creation start date. Dates are formatted “YYYY-mm-dd”. Required if is_invoice_creation_auto is set to true.
Configures whether invoices are hidden from the affiliate by default. Defaults to “false”.
Configures how many days to wait for invoice generation after the specified billing period. Defaults to 0.
Configures the minimal amount required for an invoice to be generated. Sums below the threshold are rolled over to the next billing period. Defaults to 0.
Configures the number of days that will be used as the payment term on generated invoices. Defaults to 0.
The affiliate’s billing frequency details. Required when “billing_frequency” is set to anything else than “manual” or “other”.
Specifies the day of the week, starting on. Required when “billing_frequency” is set to “weekly”.
Specifies first the day of the month. Required when “billing_frequency” is set to “bimonthly”.
Specifies second the day of the month. Required when “billing_frequency” is set to “bimonthly”.
Specifies day of the month. Required when “billing_frequency” is set to “monthly”, “two_months” or “quarterly”.
Specifies the month from which the cycle is set to begin. Required when “billing_frequency” is set to “two_months” or “quarterly”.
The affiliate’s payment method details. Required when “payment_type” is set to anything else than “none”.
The affiliate’s paxum id. Required when “payment_type” is set to “paxum”.
The reception method used with Paypal. Can be either “email”, “phone” or “paypal_account”. Required when “payment_type” is set to “paypal”.
The affiliate’s paypal reception identifier. Required when “payment_type” is set to “paypal”.
The affiliate’s email. Required when “payment_type” is set to “payoneer” or “veem”.
Whether you want to assign an existing payee id to this affiliate. Required when “payment_type” is set to “tipalti”.
The payee’s IDAP (Payee ID). Required when “payment_type” is set to “tipalti” and is_existing_payee is set to true.
The affiliate’s first name. Required when “payment_type” is set to “veem”.
The affiliate’s last name. Required when “payment_type” is set to “veem”.
The affiliate’s phone number, must be international format. Required when “payment_type” is set to “veem”.
The affiliate’s country ISO code. Required when “payment_type” is set to “veem”.
The affiliate’s bank name. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank address. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank account name. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank account number. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank routing number. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s swift code. Required when “payment_type” is set to “wire” or “direct_deposit”.
Payload Example
{
"name": "Test Affiliate",
"account_status": "active",
"network_employee_id": 1,
"internal_nodes": "This is a test affiliate created using the API",
"default_currency_id": "USD",
"enable_media_cost_tracking_links": false,
"referrer_id": 0,
"is_contact_address_enabled": true,
"contact_address": {
"address_1": "105 Ocean Avenue",
"address_2": "",
"city": "Los Angeles",
"region_code": "CA",
"country_code": "US",
"zip_postal_code": "GHGHGH"
},
"users": [
{
"first_name": "Bob",
"last_name": "Smith",
"email": "my.everflow@gmail.com",
"account_status": "active",
"initial_password": "J0hnD0e2020!"
}
],
"billing": {
"billing_frequency": "monthly",
"payment_type": "none",
"tax_id": "XXXXX",
"details": {
"day_of_month": 1,
}
}
}
Update
/v1/networks/affiliates/:affiliateId
You must specify all the fields, not only the ones you wish to update.
If you omit a field that is not marked as required, its default value will be used.
Path Parameters
Parameter | Description |
---|---|
affiliateId | The ID of the affiliate you want to update |
Body Params
The name of the affiliate
The affiliate’s account status. Can either be active
or inactive
.
The employee id of the affiliate’s account manager.
Internal notes for network usage
The affiliate’s default currency. Can be found using the metadata API (insert link)
Whether or not you want to allow affiliate to pass and override cost in their tracking links. Defaults to false.
The id of the affiliate that referred the new affiliate. Defaults to 0 (none).
Whether or not you want to include a contact address for this affiliate. Defaults to false.
The ID of the Affiliate Tier.
The affiliate’s contact address information. Only required if “is_contact_address_enabled” is set to true.
The address first line
The address second line
The city name
The region code. Can be found using the metadata API.
The country code. Can be found using the metadata API.
The ZIP or Postal code.
The affiliate’s billing information.
The affiliate’s invoicing frequency. Can be one of the following values: weekly
, bimonthly
, monthly
, two_months
, quarterly
, manual
or other
.
The affiliate’s payment type. Can be one of the following values: none
, paypal
, check
, wire
, direct_deposit
, tipalti
, payum
, veem
, payoneer
, bitcoin
, webmoney
, capitalist
, gift_card
, masspay
or skrill
The affiliate’s tax id.
Configures automatic invoice creations for the affiliate. Defaults to “false”.
Configures automatic invoice creation start date. Dates are formatted “YYYY-mm-dd”. Required if is_invoice_creation_auto is set to true.
Configures whether invoices are hidden from the affiliate by default. Defaults to “false”.
Configures how many days to wait for invoice generation after the specified billing period. Defaults to 0.
Configures the minimal amount required for an invoice to be generated. Sums below the threshold are rolled over to the next billing period. Defaults to 0, which is none.
Configures the number of days that will be used as the payment term on generated invoices. Defaults to 0.
The affiliate’s billing frequency details. Required when “billing_frequency” is set to anything else than “manual” or “other”.
Specifies the day of the week, starting on. Required when “billing_frequency” is set to “weekly”.
Specifies first the day of the month. Required when “billing_frequency” is set to “bimonthly”.
Specifies second the day of the month. Required when “billing_frequency” is set to “bimonthly”.
Specifies day of the month. Required when “billing_frequency” is set to “monthly”, “two_months” or “quarterly”.
Specifies the month from which the cycle is set to begin. Required when “billing_frequency” is set to “two_months” or “quarterly”.
The affiliate’s payment method details. Required when “payment_type” is set to anything else than “none”.
The affiliate’s paxum id. Required when “payment_type” is set to “paxum”.
The reception method used with Paypal. Can be either “email”, “phone” or “paypal_account”. Required when “payment_type” is set to “paypal”.
The affiliate’s paypal reception identifier. Required when “payment_type” is set to “paypal”.
The affiliate’s email. Required when “payment_type” is set to “payoneer” or “veem”.
Whether you want to assign an existing payee id to this affiliate. Required when “payment_type” is set to “tipalti”.
The payee’s IDAP (Payee ID). Required when “payment_type” is set to “tipalti” and is_existing_payee is set to true.
The affiliate’s first name. Required when “payment_type” is set to “veem”.
The affiliate’s last name. Required when “payment_type” is set to “veem”.
The affiliate’s phone number, must be international format. Required when “payment_type” is set to “veem”.
The affiliate’s country ISO code. Required when “payment_type” is set to “veem”.
The affiliate’s bank name. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank address. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank account name. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank account number. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s bank routing number. Required when “payment_type” is set to “wire” or “direct_deposit”.
The affiliate’s swift code. Required when “payment_type” is set to “wire” or “direct_deposit”.
Payload Example
{
"name": "Test Affiliate",
"account_status": "active",
"network_employee_id": 1,
"internal_nodes": "This is a test affiliate created using the API",
"default_currency_id": "USD",
"enable_media_cost_tracking_links": false,
"referrer_id": 0,
"is_contact_address_enabled": true,
"contact_address": {
"address_1": "105 Ocean Avenue",
"address_2": "",
"city": "Los Angeles",
"region_code": "CA",
"country_code": "US",
"zip_postal_code": "GHGHGH"
},
"billing": {
"billing_frequency": "monthly",
"payment_type": "none",
"tax_id": "XXXXX",
"details": {
"day_of_month": 1,
}
}
}