curl --request GET \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_pk}/connections/ \
--header 'Authorization: Bearer <token>'{
"count": 1023,
"results": [
{
"id": 1000,
"brand": {
"code": "demo-brand",
"id": 500,
"name": "Marla Cielo",
"joined_at": "2022-09-10T15:24:56Z",
"logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
"cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
"profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
"website": null,
"is_onboarded": false,
"is_on_rcn": false,
"requires_subscription": "enabled",
"subscription_expires_at": "2024-09-19T13:32:10Z",
"grace_period_ends_at": "2024-10-26T13:32:10Z",
"subscription_is_expired": false,
"subscription_is_on_grace_period": false,
"subscription_is_delinquent": false,
"inventory_policy": "managed",
"status": "active"
},
"retailer": {
"name": "Demo Retailer",
"code": "demo-retailer",
"id": 500,
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
"joined_at": "2021-08-03T17:24:12Z",
"is_rcn_retailer": false,
"is_onboarded": false,
"platform": "fabric",
"requires_subscription": "disabled",
"brand_permit_creation_allowed": false,
"website": "https://demoabc.com",
"status": "active"
},
"level": "full",
"status": "active",
"suspended_at": null,
"created_at": "2022-06-22T06:56:16Z",
"updated_at": "2022-08-08T15:48:05Z",
"shipping_accounts": [
{
"nickname": "Sample13",
"id": 1,
"owner": "DemoABC",
"carrier": "ALP Brand",
"shipping_methods": {
"name": "White Glove Bronze",
"code": "cory_white_glove",
"id": 5,
"type": "ltl (less than truck load)",
"carrier": {
"id": 229,
"name": "Cory Companies",
"code": "CJCD"
},
"generic_shipping_method": {
"name": "LTL",
"description": "Less than truckload (LTL)",
"id": 5,
"type": "ltl"
}
}
}
],
"options": {
"name": "Sample Option",
"code": "Sample_Option",
"id": 8753,
"description": "Sample description for connection",
"viewable_by": "All",
"editable_by": "Staff"
},
"attachments": [
{
"id": 268,
"content_type": 1,
"object_id": 666,
"file": "Sample file",
"uploaded_by": 646,
"visible_by": "connections",
"original_filename": "Sample1",
"filename": "Sample1",
"tags": [
{
"tag": "demotag",
"id": 432
}
],
"url": "https://assets.sample.com/attachments/path_to_attachment/attachment.pdf"
}
],
"approved_items_count": 1,
"orders_last_7_days_count": 0,
"proposals_received_last_7_days_count": 4,
"contacts": [
{
"name": "sample contact",
"email": "[email protected]",
"id": 1010,
"phone": "9765314368",
"description": "Call",
"created_at": "2021-09-10T15:24:56Z"
}
],
"memos": [
{
"id": 1234,
"text": "Immediate requirement",
"visibility": "any",
"acknowledged_at": "2022-01-10T15:24:56Z",
"notify_people": true,
"created_by": {
"id": 542,
"first_name": "Sample",
"last_name": "Demo",
"title": "Demo",
"status": "Active",
"type": "standard",
"photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
"profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
"is_me": true
},
"created_by_context": "retailer",
"created_at": "2021-09-10T15:24:56Z",
"updated_at": "2022-09-10T15:24:56Z"
}
],
"referral": {
"id": 125,
"referrer": {
"code": "retailer_abc",
"name": "Retailer ABC",
"id": 675
},
"referee": {
"code": "retailer_abc",
"name": "Retailer ABC",
"id": 675
},
"is_brand_first_connection": "false\"",
"is_retailer_first_connection": true
},
"integration_type": "console",
"onboarding_status": "pending",
"retailer_identifier": null,
"onboarding_target_date": null,
"onboarded_at": "2021-09-10T15:24:56Z"
}
],
"next": "https://api.example.org/demo/accounts/?page=5",
"previous": "https://api.example.org/demo/accounts/?page=3"
}Gets a list of vendor connections.
curl --request GET \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_pk}/connections/ \
--header 'Authorization: Bearer <token>'{
"count": 1023,
"results": [
{
"id": 1000,
"brand": {
"code": "demo-brand",
"id": 500,
"name": "Marla Cielo",
"joined_at": "2022-09-10T15:24:56Z",
"logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
"cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
"profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
"website": null,
"is_onboarded": false,
"is_on_rcn": false,
"requires_subscription": "enabled",
"subscription_expires_at": "2024-09-19T13:32:10Z",
"grace_period_ends_at": "2024-10-26T13:32:10Z",
"subscription_is_expired": false,
"subscription_is_on_grace_period": false,
"subscription_is_delinquent": false,
"inventory_policy": "managed",
"status": "active"
},
"retailer": {
"name": "Demo Retailer",
"code": "demo-retailer",
"id": 500,
"logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
"cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
"profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
"joined_at": "2021-08-03T17:24:12Z",
"is_rcn_retailer": false,
"is_onboarded": false,
"platform": "fabric",
"requires_subscription": "disabled",
"brand_permit_creation_allowed": false,
"website": "https://demoabc.com",
"status": "active"
},
"level": "full",
"status": "active",
"suspended_at": null,
"created_at": "2022-06-22T06:56:16Z",
"updated_at": "2022-08-08T15:48:05Z",
"shipping_accounts": [
{
"nickname": "Sample13",
"id": 1,
"owner": "DemoABC",
"carrier": "ALP Brand",
"shipping_methods": {
"name": "White Glove Bronze",
"code": "cory_white_glove",
"id": 5,
"type": "ltl (less than truck load)",
"carrier": {
"id": 229,
"name": "Cory Companies",
"code": "CJCD"
},
"generic_shipping_method": {
"name": "LTL",
"description": "Less than truckload (LTL)",
"id": 5,
"type": "ltl"
}
}
}
],
"options": {
"name": "Sample Option",
"code": "Sample_Option",
"id": 8753,
"description": "Sample description for connection",
"viewable_by": "All",
"editable_by": "Staff"
},
"attachments": [
{
"id": 268,
"content_type": 1,
"object_id": 666,
"file": "Sample file",
"uploaded_by": 646,
"visible_by": "connections",
"original_filename": "Sample1",
"filename": "Sample1",
"tags": [
{
"tag": "demotag",
"id": 432
}
],
"url": "https://assets.sample.com/attachments/path_to_attachment/attachment.pdf"
}
],
"approved_items_count": 1,
"orders_last_7_days_count": 0,
"proposals_received_last_7_days_count": 4,
"contacts": [
{
"name": "sample contact",
"email": "[email protected]",
"id": 1010,
"phone": "9765314368",
"description": "Call",
"created_at": "2021-09-10T15:24:56Z"
}
],
"memos": [
{
"id": 1234,
"text": "Immediate requirement",
"visibility": "any",
"acknowledged_at": "2022-01-10T15:24:56Z",
"notify_people": true,
"created_by": {
"id": 542,
"first_name": "Sample",
"last_name": "Demo",
"title": "Demo",
"status": "Active",
"type": "standard",
"photo_url": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
"profile_photo": "https://assets.demo.com/attachments/path_to_attachment/attachment.pdf",
"is_me": true
},
"created_by_context": "retailer",
"created_at": "2021-09-10T15:24:56Z",
"updated_at": "2022-09-10T15:24:56Z"
}
],
"referral": {
"id": 125,
"referrer": {
"code": "retailer_abc",
"name": "Retailer ABC",
"id": 675
},
"referee": {
"code": "retailer_abc",
"name": "Retailer ABC",
"id": 675
},
"is_brand_first_connection": "false\"",
"is_retailer_first_connection": true
},
"integration_type": "console",
"onboarding_status": "pending",
"retailer_identifier": null,
"onboarding_target_date": null,
"onboarded_at": "2021-09-10T15:24:56Z"
}
],
"next": "https://api.example.org/demo/accounts/?page=5",
"previous": "https://api.example.org/demo/accounts/?page=3"
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Retailer ID
Brand (vendor) IDs. Multiple comma separated values may be added
Retailer IDs. Multiple values may be separated by commas. Retailer ID
ID for verticals such as shoes, clothing, furniture. Multiple values may be added, separated by commas
Integration types such as EDI, API, WooCommerce, etc. Multiple values may be separated by commas
1: Brand (vendor) has monetary adjustments
0: Brand doesn't have adjustments
1: brand has allowances such as discounts
0: brand does not have allowances
1: brand has charges such as shipping and handling
0: brand does not have charges
Managed: brand wants to manage inventory; Unmanaged: brand does not want to manage inventory
Retailer IDs. Multiple values may be separated by commas.
Connection options enabled. Multiple values may be separated by commas.
Connection options disabled
Connection status. Multiple values may be separated by commas.
Onboarding target date is less than specified Time (Unix epoch format)
Onboarding target date is less than or equal to specified Time (Unix epoch format)
Onboarding target date is greater than specified Time (Unix epoch format)
Onboarding target date is greater than or equal to specified Time (Unix epoch format)
Sorting criteria
Page number within the paginated result set
Number of records per page
OK
Total number of records
1023
Show child attributes
Connection ID
1000
Show child attributes
Vendor code, which is vendor name in lower case and underscore
1 - 64"demo-brand"
Vendor (brand) ID
500
Vendor name
1 - 64"Marla Cielo"
Time when vendor joined Dropship (UTC format)
"2022-09-10T15:24:56Z"
URL of the brand logo
1"https://images.revcascade.com/retailers/defaults/logo-lg.png"
URL of the cover image
1"https://images.revcascade.com/retailers/defaults/cover.png"
URL of the profile image
1"https://images.revcascade.com/retailers/defaults/profile-tile.png"
URL of brand website
100null
true: Vendor is onboarded
false: Vendor is not onboarded
false
true: is on Dropship network
false: not on Dropship network
false
Represents whether subscription is required
disabled, enabled, upcoming "enabled"
Subscription expiry Time (UTC format)
"2024-09-19T13:32:10Z"
Time of grace period expiration (UTC format)
"2024-10-26T13:32:10Z"
true: subscription is expired
false: subscription is active
false
true: subscription is on grace period
false: subscription is not on grace period
false
true: subscription is overdue
false: subscription is paid
false
Inventory policy
unmanaged, managed, use_variant_policy "managed"
Vendor status
active, pending, inactive "active"
Show child attributes
Retailer name
1 - 64"Demo Retailer"
Retailer code, which is retailer name in lower case and hyphenated
1 - 32"demo-retailer"
Retailer ID
500
URL of retailer logo
1"https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png"
URL of retailer cover image
1"https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg"
URL of retailer profile image
1"https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg"
Time of retailer joining Dropship (UTC format)
"2021-08-03T17:24:12Z"
true: Retailer is in Dropship network; Retailer is not in Dropship network
false
true: Retailer is onboarded
false: Retailer is not onboarded
false
Platform on which retailer is onboarded
fabric "fabric"
Represent whether retailer requires subscription to use the platform
disabled, enabled, upcoming "disabled"
true: Platform allows creation of brand permit
false: Platform doesn't require creation of brand permit
false
Website URL
100"https://demoabc.com"
Retailer status
active, setup, ghost "active"
Connection level
basic, full "full"
Connection status
active, suspended, pending, onboarding "active"
Time of when connection got suspended (UTC format)
null
Time of connection creation (UTC format)
"2022-06-22T06:56:16Z"
Time of connection update (UTC format)
"2022-08-08T15:48:05Z"
Show child attributes
Short name of shipping account, for easier identification
1 - 64"Sample13"
Shippping account ID
1
Owner of shipping account
"DemoABC"
Shipping carrier
"ALP Brand"
Show child attributes
Name of shipping method
1 - 64"White Glove Bronze"
Code of shipping method
1 - 64"cory_white_glove"
ID of shipping method
5
Type of shipping method
small_parcel, ltl "ltl (less than truck load)"
Show child attributes
Carrier ID
229
Carrier name
1 - 64"Cory Companies"
Carrier code
1 - 64"CJCD"
Show child attributes
Name of shipping method
1 - 32"LTL"
Description of shipping method
1 - 128"Less than truckload (LTL)"
ID of shipping method
5
Type of shipping method
small_parcel, ltl "ltl"
Show child attributes
Option name
1 - 64"Sample Option"
Option code
1 - 64"Sample_Option"
Option ID
8753
Connection description
"Sample description for connection"
User who can view the connection details
retailer, brand, all, none "All"
User who can edit connection
retailer, brand, staff "Staff"
Show child attributes
Attachment or document ID
268
Content type
1
Attachement object ID
666
File name
"Sample file"
User ID that uploaded the attachment
646
User permission who can view the attachment
me, connections, everyone "connections"
Original file name
255"Sample1"
File name used for sharing
255"Sample1"
URL of attachment
1"https://assets.sample.com/attachments/path_to_attachment/attachment.pdf"
Count of approved items
1
Count of orders in the last 7 days
0
Count of proposals received in the last 7 days
4
Show child attributes
Contact name
1 - 128"sample contact"
Contact ID
1010
Contact number
16"9765314368"
A note related to the contact
128"Call"
Time of contact creation (UTC format)
"2021-09-10T15:24:56Z"
Show child attributes
Memo ID
1234
Memo text
"Immediate requirement"
Memo visibility
any, retailer, brand "any"
Time memo acknowledgement (UTC format)
"2022-01-10T15:24:56Z"
true: notify stakeholders
false: do not notify
true
Show child attributes
User ID who accepted or rejected the invoice
542
First name of user
64"Sample"
Last name of user
64"Demo"
User title
64"Demo"
User status
active, invited, locked "Active"
User type
standard, api "standard"
URL of the user photo
1"https://assets.demo.com/attachments/path_to_attachment/attachment.pdf"
URL of the user's profile photo
1"https://assets.demo.com/attachments/path_to_attachment/attachment.pdf"
true: user is me:
false: user is not me
true
Represents whether memo is created by retailer or brand?
retailer, brand "retailer"
Time of memo creation (UTC format)
"2021-09-10T15:24:56Z"
Time of memo update (UTC format)
"2022-09-10T15:24:56Z"
Show child attributes
ID of connection referral
125
Show child attributes
Retailer or Vendor (Brand) code
1 - 32"retailer_abc"
Retailer or Vendor (Brand) name
1 - 64"Retailer ABC"
Retailer or Vendor (Brand) ID
675
Show child attributes
Retailer or Vendor (Brand) code
1 - 32"retailer_abc"
Retailer or Vendor (Brand) name
1 - 64"Retailer ABC"
Retailer or Vendor (Brand) ID
675
true: brand is first connection
false: brand is not the first connection
"false\""
true: retailer is first connection
false: brand is not the first connection
true
Integration type
console, edi, api, storefront, console-print-labels, console-register-tracking-numbers, shopify, bigcommerce, shipstation "console"
Status of onboarding
pending, complete "pending"
Retailer ID
32null
Target date of retailer onboarding (UTC format)
null
Time of retailer onboarding (UTC format)
"2021-09-10T15:24:56Z"
Next page (applicable in a paginated response)
"https://api.example.org/demo/accounts/?page=5"
Previous page (applicable in a paginated response)
"https://api.example.org/demo/accounts/?page=3"
Was this page helpful?