Get all proposal departments

curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/brands/{brand_id}/connections/{id}/departments/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "results": [
    {
      "id": 1418,
      "retailer": {
        "id": 1233,
        "name": "fabric Merchant",
        "code": "fabric-merchant",
        "logo_url": "https://assets.revcascade.com/retailers/d8b42096-5e46-41e4-bde0-80c17d3d3a52",
        "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
        "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
        "joined_at": "2022-05-27T03:07:59.000Z",
        "is_3pm": false,
        "is_rcn_retailer": false,
        "is_onboarded": true,
        "platform": "fabric",
        "requires_subscription": "disabled",
        "brand_permit_creation_allowed": true,
        "website": "https://www.fabric.inc",
        "status": "active",
        "indexing_template_id": null
      },
      "owner_user": {
        "id": 1002,
        "first_name": "Kyle",
        "last_name": "Stainer",
        "title": "Engineering",
        "status": "active",
        "type": "standard",
        "photo_url": "https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg",
        "profile_photo": "https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg",
        "is_me": false
      },
      "manager_user": null,
      "name": "fabric Merchant Apparel",
      "code": "fabric-merchant-general",
      "sample_template_url": "https://res.cloudinary.com/revcascade/raw/upload/v1658950690/sample-templates/ApparelBad.csv",
      "description": null,
      "template": {
        "id": 3245,
        "name": "fabric General Merchandise",
        "code": "fabric-general-merchandise"
      },
      "brand_ruleset": {
        "id": 36
      },
      "retailer_ruleset": {
        "id": 37
      },
      "is_active": true
    }
  ],
  "next": "https://api.example.org/demo/{retailer_id}/?page=5",
  "previous": "https://api.example.org/demo/{retailer_id}/?page=3"
}

GET

brands

{brand_id}

connections

{id}

departments

Get all proposal departments

curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/brands/{brand_id}/connections/{id}/departments/ \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "results": [
    {
      "id": 1418,
      "retailer": {
        "id": 1233,
        "name": "fabric Merchant",
        "code": "fabric-merchant",
        "logo_url": "https://assets.revcascade.com/retailers/d8b42096-5e46-41e4-bde0-80c17d3d3a52",
        "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
        "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
        "joined_at": "2022-05-27T03:07:59.000Z",
        "is_3pm": false,
        "is_rcn_retailer": false,
        "is_onboarded": true,
        "platform": "fabric",
        "requires_subscription": "disabled",
        "brand_permit_creation_allowed": true,
        "website": "https://www.fabric.inc",
        "status": "active",
        "indexing_template_id": null
      },
      "owner_user": {
        "id": 1002,
        "first_name": "Kyle",
        "last_name": "Stainer",
        "title": "Engineering",
        "status": "active",
        "type": "standard",
        "photo_url": "https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg",
        "profile_photo": "https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg",
        "is_me": false
      },
      "manager_user": null,
      "name": "fabric Merchant Apparel",
      "code": "fabric-merchant-general",
      "sample_template_url": "https://res.cloudinary.com/revcascade/raw/upload/v1658950690/sample-templates/ApparelBad.csv",
      "description": null,
      "template": {
        "id": 3245,
        "name": "fabric General Merchandise",
        "code": "fabric-general-merchandise"
      },
      "brand_ruleset": {
        "id": 36
      },
      "retailer_ruleset": {
        "id": 37
      },
      "is_active": true
    }
  ],
  "next": "https://api.example.org/demo/{retailer_id}/?page=5",
  "previous": "https://api.example.org/demo/{retailer_id}/?page=3"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id

number

required

The unique brand ID. In the Dropship UI this is called the Supplier ID. To find your Supplier ID, click your supplier name in the top nav.

integer

required

The unique connection id. This ID is automatically generated when a connection is created.

Response

200 - application/json

count

integer

required

The total number of records

Example:

100

results

object[]

required

Show child attributes

results.id

integer<int64>

The unique identifier of the feed.

Example:

1418

results.retailer

object

Details about the associated retailer.

Show child attributes

results.retailer.id

integer<int64>

The unique identifier of the retailer.

Example:

1233

results.retailer.name

string

The name of the retailer.

Example:

"fabric Merchant"

results.retailer.code

string

A unique code for the retailer.

Example:

"fabric-merchant"

results.retailer.logo_url

string<url>

URL to the retailer's logo.

Example:

"https://assets.revcascade.com/retailers/d8b42096-5e46-41e4-bde0-80c17d3d3a52"

results.retailer.cover_url

string<url>

URL to the retailer's cover image.

Example:

"https://images.revcascade.com/retailers/defaults/cover.png"

results.retailer.profile_tile_url

string<url>

URL to the retailer's profile tile image.

Example:

"https://images.revcascade.com/retailers/defaults/profile-tile.png"

results.retailer.joined_at

string<date-time>

Timestamp when the retailer joined.

Example:

"2022-05-27T03:07:59.000Z"

results.retailer.is_3pm

boolean

Indicates if the retailer is a 3PM (Third-Party Merchant).

Example:

false

results.retailer.is_rcn_retailer

boolean

Indicates if the retailer is an RCN (RevCascade Network) retailer.

Example:

false

results.retailer.is_onboarded

boolean

Indicates if the retailer has completed onboarding.

Example:

true

results.retailer.platform

string

The platform the retailer uses.

Example:

"fabric"

results.retailer.requires_subscription

string

Indicates if the retailer requires a subscription (e.g., 'disabled').

Example:

"disabled"

results.retailer.brand_permit_creation_allowed

boolean

Indicates if brand permit creation is allowed for this retailer.

Example:

true

results.retailer.website

string<url>

The retailer's website URL.

Example:

"https://www.fabric.inc"

results.retailer.status

string

The current status of the retailer (e.g., 'active').

Example:

"active"

results.retailer.indexing_template_id

integer<int64> | null

The ID of the indexing template, if any.

Example:

null

results.owner_user

object

Details about the user who owns this feed.

Show child attributes

results.owner_user.id

integer<int64>

The unique identifier of the user.

Example:

1002

results.owner_user.first_name

string

The first name of the user.

Example:

"Kyle"

results.owner_user.last_name

string

The last name of the user.

Example:

"Stainer"

results.owner_user.title

string

The title or role of the user.

Example:

"Engineering"

results.owner_user.status

string

The current status of the user (e.g., 'active').

Example:

"active"

results.owner_user.type

string

The type of user (e.g., 'standard').

Example:

"standard"

results.owner_user.photo_url

string<url>

URL to the user's photo.

Example:

"https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg"

results.owner_user.profile_photo

string<url>

URL to the user's profile photo.

Example:

"https://images.revcascade.com/users/2c5346e8b01f40de8977d29ee038f995/photo.jpg"

results.owner_user.is_me

boolean

Indicates if the user is the current authenticated user.

Example:

false

results.manager_user

object

Details about the manager user, if any.

Example:

null

results.name

string

The name of the feed.

Example:

"fabric Merchant Apparel"

results.code

string

A unique code for the feed.

Example:

"fabric-merchant-general"

results.sample_template_url

string<url> | null

URL to a sample template for this feed.

Example:

"https://res.cloudinary.com/revcascade/raw/upload/v1658950690/sample-templates/ApparelBad.csv"

results.description

string | null

A description of the feed.

Example:

null

results.template

object

Details about the template used for this feed.

Show child attributes

results.template.id

integer<int64>

The unique identifier of the template.

Example:

3245

results.template.name

string

The name of the template.

Example:

"fabric General Merchandise"

results.template.code

string

The code of the template.

Example:

"fabric-general-merchandise"

results.brand_ruleset

object

Details about the brand ruleset applied to this feed.

Show child attributes

results.brand_ruleset.id

integer<int64>

The unique identifier of the brand ruleset.

Example:

36

results.retailer_ruleset

object

Details about the retailer ruleset applied to this feed.

Show child attributes

results.retailer_ruleset.id

integer<int64>

The unique identifier of the retailer ruleset.

Example:

37

results.is_active

boolean

Indicates if the feed is active.

Example:

true

string<uri> | null

Next page (applicable in a paginated response)

Example:

"https://api.example.org/demo/{retailer_id}/?page=5"

string<uri> | null

Previous page (applicable in a paginated response)

Example:

"https://api.example.org/demo/{retailer_id}/?page=3"

Create a product variant Get a specific departments details

⌘I

Dropship

Merchants

Merchant API Endpoints

Suppliers

Supplier API Endpoints

Get all proposal departments

Authorizations

Path Parameters

Response