Authentication v1
- Identity APIs
- User
- Address
- Auth
User Self Service APIs
- Introduction
- User Self Service APIs
- Authentication APIs
Experiences v2 (XM v2)
- XM
- Pages
- Global Components
- Menu
Experiences v1 (XM v1)
- XM
- Pages
- Global Components
- Menu
Product Catalog
- Product Catalog
- Category
- Product
- Attributes
- Bulk Import
Orders v2 (OMS v2)
- Order Management System
- Order
- Order Attribute
- Developer Guide
- Order Return
- Payment Status
- Package Tracking
- Cross Border
- Order Cancellation
- Appeasement
- Allocation
- Configuration
- Fraud Configuration
- Target Configuration
- Location
- Location Attribute
- Inventory Network
- Inventory
- Inventory Counter
- Inventory Bulk Operation
- Inventory Attribute
- Inventory Upload Log
- Shipment
- Shipping Method
- Webhook
- Notification
- Export
- Invoice
- Fraud
- Backorder Preorder Reservation
- List
Orders v1 (OMS v1)
- Order Management System
- Cart
- Bill To
- Ship To
- Wishlist
- Cart Decoupled
- Warehouse
- Inventory
- Attributes
- List
- Tax/Address Validate
- Shipping
- Payments
- Order
Offers v2
- Offers
- Developer Guide
- Promotion
- Price Kind
- Dynamic Pricing Engine
- Segment
- Coupon
- Coupon Codes
- Product
- Price List
- Attributes
- Item
- Price Guard
- Global Exclusion
- Upload Price CSV
- Pricing
- Redemption
- Exports
Offers v1
- Offers
- Login API
- Promotions
- Pricing
Subscriptions (SMT API)
- Subscriptions API
- Cancellation Reasons
- Subscription Discounts
- Subscriptions
- Subscribers
- Orders
Loyalty (Member)
- Member APIs
- Inquire
- Discounts
- Redeem
- Earn
- Members
Dropship
- Dropship API
- Shipments
- Products
- Invoices
- Connections
- Inventory
- Developer Guide
- Returns
- Orders
Cart API
- Cart
- Order Draft
- Attribute
- Adjustments
- Shipping
- Cart
Checkout API
- Checkout
- Checkout
Customer
- Core Concepts
- Customer Service
- Organization
- User Party
- Organization Group Addresses
- User Internal Party
- Organization Contracts
- Party
- Party Contracts
- Contracts
- User
- Search
- User Trait
- Organization Users
- Address
- User Address
- Trait
- Party Address
- Party Trait
- Organization Group Users
- Internal Party
- Contract Pricelist
- Internal Parties Party
- Account
- Party Account
- Organization Addresses
- Organization Groups
- Individual Addresses
- Users Organization
- Individual
Get vendor connections
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,
"next": "https://api.example.org/demo/accounts/?page=5",
"previous": "https://api.example.org/demo/accounts/?page=3",
"results": [
{
"id": 1000,
"brand": {
"id": 500,
"name": "Marla Cielo",
"code": "demo-brand",
"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": {
"id": 500,
"name": "Demo Retailer",
"code": "demo-retailer",
"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": [
{
"id": 1,
"nickname": "Sample13",
"owner": "DemoABC",
"carrier": "ALP Brand",
"shipping_methods": {
"id": 5,
"name": "White Glove Bronze",
"code": "cory_white_glove",
"type": "ltl (less than truck load)",
"carrier": {
"id": 229,
"name": "Cory Companies",
"code": "CJCD"
},
"generic_shipping_method": {
"id": 5,
"name": "LTL",
"description": "Less than truckload (LTL)",
"type": "ltl"
}
}
}
],
"options": {
"id": 8753,
"name": "Sample Option",
"code": "Sample_Option",
"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": [
{
"id": 432,
"tag": "demotag"
}
],
"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": [
{
"id": 1010,
"name": "sample contact",
"email": "demo@xyz.com",
"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": {
"id": 675,
"code": "retailer_abc",
"name": "Retailer ABC"
},
"referee": {
"id": 675,
"code": "retailer_abc",
"name": "Retailer ABC"
},
"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"
}
]
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Retailer ID
Query Parameters
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 <br /> 0: Brand doesn't have adjustments
1: brand has allowances such as discounts <br /> 0: brand does not have allowances
1: brand has charges such as shipping and handling <br /> 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
Response
Total number of records
1023
Connection ID
1000
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
100
null
true: Vendor is onboarded <br /> false: Vendor is not onboarded
false
true: is on Dropship network <br /> 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 <br /> false: subscription is active
false
true: subscription is on grace period <br /> false: subscription is not on grace period
false
true: subscription is overdue <br /> false: subscription is paid
false
Inventory policy
unmanaged
, managed
, use_variant_policy
"managed"
Vendor status
active
, pending
, inactive
"active"
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 <br /> 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 <br /> 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"
Short name of shipping account, for easier identification
1 - 64
"Sample13"
Shippping account ID
1
Owner of shipping account
"DemoABC"
Shipping carrier
"ALP Brand"
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)"
Carrier ID
229
Carrier name
1 - 64
"Cory Companies"
Carrier code
1 - 64
"CJCD"
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"
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"
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
Contact name
1 - 128
"sample contact"
Contact email
1 - 128
"demo@xyz.com"
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"
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 <br /> false: do not notify
true
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: <br /> 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"
ID of connection referral
125
Retailer or Vendor (Brand) code
1 - 32
"retailer_abc"
Retailer or Vendor (Brand) name
1 - 64
"Retailer ABC"
Retailer or Vendor (Brand) ID
675
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 <br /> false: brand is not the first connection
"false\""
true: retailer is first connection <br /> 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
32
null
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?
curl --request GET \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_pk}/connections/ \
--header 'Authorization: Bearer <token>'
{
"count": 1023,
"next": "https://api.example.org/demo/accounts/?page=5",
"previous": "https://api.example.org/demo/accounts/?page=3",
"results": [
{
"id": 1000,
"brand": {
"id": 500,
"name": "Marla Cielo",
"code": "demo-brand",
"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": {
"id": 500,
"name": "Demo Retailer",
"code": "demo-retailer",
"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": [
{
"id": 1,
"nickname": "Sample13",
"owner": "DemoABC",
"carrier": "ALP Brand",
"shipping_methods": {
"id": 5,
"name": "White Glove Bronze",
"code": "cory_white_glove",
"type": "ltl (less than truck load)",
"carrier": {
"id": 229,
"name": "Cory Companies",
"code": "CJCD"
},
"generic_shipping_method": {
"id": 5,
"name": "LTL",
"description": "Less than truckload (LTL)",
"type": "ltl"
}
}
}
],
"options": {
"id": 8753,
"name": "Sample Option",
"code": "Sample_Option",
"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": [
{
"id": 432,
"tag": "demotag"
}
],
"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": [
{
"id": 1010,
"name": "sample contact",
"email": "demo@xyz.com",
"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": {
"id": 675,
"code": "retailer_abc",
"name": "Retailer ABC"
},
"referee": {
"id": 675,
"code": "retailer_abc",
"name": "Retailer ABC"
},
"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"
}
]
}