NAV Navbar

Introduction

Welcome to the Trinity Apparel API!

Our RESTful API is used for our internal apps, dealers, and manufacturers. Here is an overview of our sections:

API Name Description
Orders API
readonly
Dealers can review their orders and all garments in those orders
Measurements API
readonly
Explore Options
Options API
readonly
Explore Options
Fabrics API
readonly
Search and Explore Fabrics
Materials API
readonly
Explore buttons, threads, felts, etc
Customers API
write
Explore your customers and add basic customer records
Manufacturers API
write
Manage orders at a factory
Shipping API
write
Receive and manage shipments at a factory

Authorization

To authorize, use this code:

# Pass the correct header with each request
curl "api_endpoint_here"
  -H "Authorization Bearer: swaledale"

Make sure to replace swaledale with your JWT.

All routes require a valid JSON Web Tokens (JWT) token. JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties. Learn more at https://jwt.io/

You'll pass the JWT in the header like this:

Authorization Bearer: eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOjg4LCJleHAiOjE1Njc4NDY5MTksImlhdCI6MTUzNjMxMDkxOSwiaXNzIjoiVHJpbml0eSBBUEkgVjEiLCJqdGkiOiIwYmUxY2IzNTY4NGVkYzhiYTY3YjM0YmRiMTUyZTlkMiJ9.UP7T1J0OM4lBWT3eB6s18qfo1XYI45-w5XIyd94LKlbIRsu1EzGyJrCm6sCwzBi3f3a-4I3wwxAUlt-t7NJP9rCSkWMOMzEOCNOU-waML0tU2dnh_mptxDJCE4GlY8JSTFVXbVGv1r6xDYi0xmy3UJHpW4rsoSUgLBPnTIzsZiE

Errors

The Trinity API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your JWT token is invalid.
403 Forbidden -- You are not allowed to access this resource.
404 Not Found -- The specified resource could not be found.
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Pagination

Users can navigate through pages of results with the following parameters:

Parameter Default Description
page 0 View a specific page of results; Page starts at 0
per_page 25 Specific number of results to return per page

Resources that use pagination:

Orders API

Order Statuses

All garments are in a particular order statuses. While a garment is being produced it flows through a number of different statuses. Here is a list of all possible status codes:

Status Code Description
INCOMPLETE Incomplete
READY Ready
PREP Blue Pencil
CUTTING Cutting
PRODUCTION Production
MADE Production Complete
SHIPDC International Transit
INSPECTDC Final Inspection
SHIPCUST Delivery
FABHOLD Fabric Hold
PACKDC Shipment Processing
SHIPDIRECT Direct Ship
CANCEL Canceled
CMTHOLD CMT Fabric Hold

Delay Statuses

Sometimes a garment gets delayed during production. We categorize the reason for the delay in an effort to speed up the process. Here is a list of all possible delay codes:

Delay Code Description
OK Not Delayed
FABRIC_OUT Fabric Out
FABRIC_RECEIPT Fabric Receipt Delay
FABRIC_DAMAGED Fabric Flawed/Damaged
FABRIC_SHORT Fabric Short
DEALER_INSTRUCT Dealer Instruction Required
GARMENT_DAMAGED Garment Damaged Delay
TRINITY_REVIEW Trinity Review
DEALER_HOLD Dealer Hold
CMT_SHELL CMT Shell Fabric Delay
CMT_LINING CMT Lining Fabric Delay
CMT_TRIM CMT Trim Fabric Delay
PATTERN_REVIEW Pattern Review
FACTORY_REVIEW ID Review

Garment Types

Description of what the different garment type codes mean:

Garment Type Description Bitmask
CSC Coat 1
CV Vest 2
CT Pant 4
CCP Coat & Pant 5 (multi)
CCVP Coat, Vest & Pant 7 (multi)
CSHT Shirt 8
CCPP Coat, Pant, & Pant 21 (multi)
CCVPP Coat, Vest, Pant & Pant 23 (multi)
CTOPC Topcoat 32
CSHO Short 64
CBK Breek 128
TIE Tie 256
SWK Swacket 512

Order Resources

The Orders API returns order, garment, order status, and delay status objects. These objects can also return these subresources: dealer, customer, currency, address, etc

Order

# Standard Object - Used in a resource collection
{
    "id": 399780,
    "title": "DO-399780",
    "custom_order_number": null,
    "garment_count": 7,
    "ship_type": "In-Store Pick-Up",
    "ship_cost": "0.0",
    "subtotal": "2554.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "2554.0",
    "deposit_percentage": 50,
    "current_balance": "2554.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2018-06-29T10:55:15.000Z",
    "created_at": "2018-06-29T09:42:51.000Z",
    "invoiced_at": null,
    "currency": ...,
}

Standard Attributes

Attribute Description
id
string
Unique identifier for the object
title
string
Our SKU field for orders
custom_order_number
string
Dealers can set this field to whatever they want. It is typically the dealer's SKU or a summary of the order
garment_count
integer
How many garments are in the order. multi-piece garments (e.g., Suit) are counted as 1.
ship_type
string
How is the garment shipped to the final destination
ship_cost
decimal
How much did it cost to ship the whole order
subtotal
decimal
Order amount before tax and discounts are included
dealer_discount
decimal
Dealer discount is the amount of dealer's permanent discounts
total_discount
decimal
Dollar total of all discounts applied to the order
tax
decimal
Dollar total for taxes on the order
grand_total
decimal
Dollar total for the whole order. Used as a basis for credit card charges and invoices.
deposit_percentage
integer
The percentage of the grand total that must be paid before the order enters production. A number between 0 and 100. The final amount is typically paid after it is made and before it ships to the final destination.
current_balance
decimal
The dollar amount remaining to be paid on the order
measurement_units
string
Units can be uscust for US customary units (in) or si for metric units (cm)
payment_status
string
An indication if the order has been paid for
ordered_at
datetime
Time that the dealer completed the checkout process and officially placed the order
created_at
datetime
Time when the dealer first began adding garments to the order
invoiced_at
datetime
Time of the first invoice
currency
subresource
Currency used in the order
# Extended Object
{
    "id": 399780,
    "title": "DO-399780",
    "custom_order_number": null,
    "garment_count": 7,
    "ship_type": "In-Store Pick-Up",
    "ship_cost": "0.0",
    "subtotal": "2554.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "2554.0",
    "deposit_percentage": 50,
    "current_balance": "2554.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2018-06-29T10:55:15.000Z",
    "created_at": "2018-06-29T09:42:51.000Z",
    "invoiced_at": null,
    "order_type": "MTM",
    "order_source": "workflo",
    "currency": ...,
    "shipping_address": ...,
    "factory_address": ...,
    "dealer": ...,
    "customer": ...,
    "garments": [ ... ]
}

Extended Attributes

Attribute Description
order_type
string
MTM, Inventory, or MTO (future)
order_source
string
What system was used to place the order? workflo or studio
shipping_address
subresource
Address of the final destination
factory_address
subresource
Address where it was made
dealer
subresource
Dealer who placed the order
customer
subresource
Person who will wear the garments
garments
array
Array of garments included in the order

Currency

# Standard Object - Used in a resource collection
{
    "name": "USD",
    "symbol": "$",
    "rate": "1.0"
}

Standard Attributes

Attribute Description
name
string
Type of currency used
symbol
string
Symbol of currency used
rate
string
Description TBD

Shipping Address

# Standard Object - Used in a resource collection
{
    "id": 1477,
    "description": "Trinity",
    "street1": "193 Business Park Dr",
    "street2": null,
    "street3": null,
    "city": "Ridgeland",
    "state": "MS",
    "zip": "39157",
    "country": "USA",
    "phone": null
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
description
string
Brief description of address
street1
string
First street line of address
street2
string
Second street line of address
street3
string
Third street line of address
city
string
City for the address
state
string
State for the address
zip
string
Zip Code for the address
country
string
Country for the address
phone
string
Phone number for the address

Factory Address

# Standard Object - Used in a resource collection
{
    "id": 1,
    "description": "Trinity USA",
    "street1": "227 Marketridge Dr",
    "street2": null,
    "street3": null,
    "city": "Ridgeland",
    "state": "MS",
    "zip": "39157",
    "country": "USA",
    "phone": "601-713-2628"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
description
string
Brief description of address
street1
string
First street line of address
street2
string
Second street line of address
street3
string
Third street line of address
city
string
City for the address
state
string
State for the address
zip
string
Zip Code for the address
country
string
Country for the address
phone
string
Phone number for the address

Dealer

# Standard Object - Used in a resource collection
{
    "id": 1106,
    "name": "Studio Garments",
    "first_name": "Studio",
    "last_name": "Garments",
    "company_name": null,
    "email": "jwiggins@idpbp.com",
    "phone": "6017132628",
    "country": "USA"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
name
string
Combined string for first and last name
first_name
string
First name of the dealer
last_name
string
Last name of the dealer
company_name
string
Name of the dealer's company
email
string
Email address of the dealer
phone
string
Phone number of the dealer
country
string
Country where the dealer is

Garment

# Standard Object - Used in a resource collection
{
    "id": 892902,
    "title": "ID-892902",
    "order_id": 407781,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-17T09:50:45.000Z",
    "updated_at": "2018-08-29T03:52:13.000Z",
    "order_status": ...,
    "delay_status": ...,
    "dealer_order": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
title
string
Our SKU field which includes the garment id number and information about where the factory will send the garment
order_id
integer
Each garment must be a part of a specific order
copied_garment_id
integer
Garment id if this was copied from a previous order
price
decimal
Wholesale cost of the garment
option_cost
decimal
Dollar cost of the premium options used in this garment
garment_type
string
Type of garment. Click here for more info
created_at
datetime
When the garment was first created (but not ordered)
updated_at
datetime
When the garment was last modified
order_status
subresource
Current status of the order. Click here for more info
delay_status
subresource
If garment is delayed, this will return why. Click here for more info
dealer_order
subresource
The full order placed by a single customer. Includes this garment and can include more garments.
# Extended Object
{
    "id": 892902,
    "title": "ID-892902",
    "order_id": 407781,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-17T09:50:45.000Z",
    "updated_at": "2018-08-29T03:52:13.000Z",
    "prefix": "ID",
    "index": "2/2",
    "last_status_change_date": "2018-09-14T14:20:40.000Z",
    "last_delay_change_date": null,
    "order_status": ...,
    "delay_status": ...,
    "dealer_order": ...,
    "manufacturer": ...,
    "fabric": ...
}

Extended Attributes

Attribute Type Description
prefix string First part of the title. This indicates where the order was made or where the factory will send the garment
index string Sequence number (1/7, 2/7, 3/7 ...) for each garment in an order. Each item has a different index
last_status_change_date datetime When did the order status last change to a new state
last_delay_change_date datetime When did the delay status last change to a new state
manufacturer subresource The factory who made the garment
fabric subresource Information about the primary fabric used for the garment

Order Status

# Standard Object - Used in a resource collection
{
    "code": "SHIPCUST",
    "name": "Delivery",
    "description": "Delivery"
}

Standard Attributes - see here for details

Attribute Description
code
string
Trinity code for order status
name
string
The name of the order status
description
string
Description of order status

Delay Status

# Standard Object - Used in a resource collection
{
    "code": "OK",
    "description": "Not Delayed"
}

Standard Attributes - see here for details

Attribute Description
code
string
Trinity code for delay status
description
string
Description of delay status

Manufacturer

# Standard Object - Used in a resource collection
{
    "id": 2,
    "address_id": 1943,
    "name": "iD Shirts",
    "email": "info@trinity-apparel.com"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
name
string
Name of the manufacturer
email
string
Email address of the manufacturer

Garment Options

# Standard Object - Used in a resource collection
{
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": ...,
    "option_value": ...
}

Standard Attributes

Attribute Description
updated_at
datetime
The last time the garment option was updated.
text
string
If the option has a text value (E.g., monogram, label, etc), it will be returned here.
option
subresource
Detailed object for the option.
option_value
subresource
Detailed object for the option value.

Option

# Standard Object - Used in a resource collection
{
    "id": 67,
    "name": "collar",
    "description": "Collar",
    "display_order": 1
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the option.
description
string
A human readable description of the option.
display_order
integer
The order in which the option is displayed in Workflow.

Option Value

# Standard Object - Used in a resource collection
{
    "id": 520,
    "option_value": "american_spread",
    "description": "American Spread",
    "display_order": 12
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
option_value
string
The name of the option value.
description
string
A human readable description of the option value.
display_order
integer
The order in which the option value is displayed in Workflow.

Garment Measurements

# Standard Object - Used in a resource collection
{
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0.000",
    "measurement": ...,
    "measurement_value": ...
}

Standard Attributes

Attribute Description
updated_at
datetime
The last time the garment option was updated.
text
string
The text value that is associated to the measurement when applicable.
measurement
subresource
Detailed object for the measurement.
meaurement_value
subresource
Detailed object for measurement value.

Measurement

# Standard Object - Used in a resource collection
{
    "id": 7,
    "name": "perkins_incline",
    "description": "Incline Reading",
    "display_order": 5
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the measurement.
description
string
A human readable description of the measurement.
display_order
integer
The order in which the measurement is displayed in Workflow.

Measurement Value

# Standard Object - Used in a resource collection
{
    "id": 16,
    "value": "0.000",
    "description": "",
    "display_order": 1
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
value
string
The name of the measurement value.
description
string
A human readable description of the measurement value.
display_order
integer
The order in which the measurement value is displayed in Workflow.

Get All Orders (DOs)

curl "https://api.trinity-apparel.com/v1/orders"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 299151,
    "title": "DO-299151",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "9.0",
    "subtotal": "40.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "49.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-19T20:12:47.000Z",
    "created_at": "2017-01-19T20:09:41.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299152,
    "title": "DO-299152",
    "custom_order_number": "RD-01",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "1076.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "1098.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-23T15:29:46.000Z",
    "created_at": "2017-01-19T20:20:00.000Z",
    "invoiced_at": "2017-03-15T12:46:50.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299153,
    "title": "DO-299153",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "9.0",
    "subtotal": "44.5",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "53.5",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-19T20:46:22.000Z",
    "created_at": "2017-01-19T20:38:30.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299154,
    "title": "DO-299154",
    "custom_order_number": null,
    "garment_count": 9,
    "ship_type": "Ground",
    "ship_cost": "33.0",
    "subtotal": "1492.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "1525.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-19T21:17:47.000Z",
    "created_at": "2017-01-19T20:38:56.000Z",
    "invoiced_at": "2017-02-23T13:10:05.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299155,
    "title": "DO-299155",
    "custom_order_number": null,
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "14.0",
    "subtotal": "634.4",
    "dealer_discount": "34.2",
    "total_discount": "34.2",
    "tax": "122.84",
    "grand_total": "737.04",
    "deposit_percentage": 0,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-19T22:21:46.000Z",
    "created_at": "2017-01-19T21:26:00.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "GBP",
      "symbol": "£",
      "rate": "0.625"
    }
  },
  {
    "id": 299156,
    "title": "DO-299156",
    "custom_order_number": null,
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "633.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "655.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-19T22:39:03.000Z",
    "created_at": "2017-01-19T22:15:27.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299157,
    "title": "DO-299157",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "449.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "460.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-27T01:51:46.000Z",
    "created_at": "2017-01-20T01:13:25.000Z",
    "invoiced_at": "2017-02-28T11:35:25.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299158,
    "title": "DO-299158",
    "custom_order_number": "2262rm",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "6.0",
    "subtotal": "80.0",
    "dealer_discount": "4.0",
    "total_discount": "4.0",
    "tax": "16.4",
    "grand_total": "98.4",
    "deposit_percentage": 0,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T07:03:09.000Z",
    "created_at": "2017-01-20T07:00:53.000Z",
    "invoiced_at": "2017-02-15T08:54:48.000Z",
    "currency": {
      "name": "GBP",
      "symbol": "£",
      "rate": "0.625"
    }
  },
  {
    "id": 299160,
    "title": "DO-299160",
    "custom_order_number": "Cousin Order",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "33.0",
    "subtotal": "1678.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "1711.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-03-01T13:13:07.000Z",
    "created_at": "2017-01-20T07:27:04.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299164,
    "title": "DO-299164",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "519.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "530.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T07:58:40.000Z",
    "created_at": "2017-01-20T07:51:25.000Z",
    "invoiced_at": "2017-02-15T13:37:10.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299165,
    "title": "DO-299165",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "9.0",
    "subtotal": "75.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "84.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T08:03:29.000Z",
    "created_at": "2017-01-20T07:59:46.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299166,
    "title": "DO-299166",
    "custom_order_number": null,
    "garment_count": 4,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "493.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "515.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T08:40:46.000Z",
    "created_at": "2017-01-20T08:11:03.000Z",
    "invoiced_at": "2017-02-20T10:46:29.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299167,
    "title": "DO-299167",
    "custom_order_number": "3898 Rothfeldt",
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "9.0",
    "subtotal": "59.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "68.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T08:33:36.000Z",
    "created_at": "2017-01-20T08:28:17.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299168,
    "title": "DO-299168",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "6.0",
    "subtotal": "43.25",
    "dealer_discount": "2.16",
    "total_discount": "2.16",
    "tax": "9.42",
    "grand_total": "56.51",
    "deposit_percentage": 0,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T11:28:44.000Z",
    "created_at": "2017-01-20T08:46:28.000Z",
    "invoiced_at": "2017-02-15T08:54:49.000Z",
    "currency": {
      "name": "GBP",
      "symbol": "£",
      "rate": "0.625"
    }
  },
  {
    "id": 299169,
    "title": "DO-299169",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "9.0",
    "subtotal": "344.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "353.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T08:53:36.000Z",
    "created_at": "2017-01-20T08:50:18.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299170,
    "title": "DO-299170",
    "custom_order_number": "Q2656",
    "garment_count": 6,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "354.0",
    "dealer_discount": "28.32",
    "total_discount": "28.32",
    "tax": "0.0",
    "grand_total": "347.68",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T09:28:35.000Z",
    "created_at": "2017-01-20T08:58:54.000Z",
    "invoiced_at": "2017-02-22T10:00:28.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299172,
    "title": "DO-299172",
    "custom_order_number": "1181517/Daub/LA",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "499.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "521.0",
    "deposit_percentage": 50,
    "current_balance": "521.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2017-01-20T09:36:22.000Z",
    "created_at": "2017-01-20T09:05:57.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299173,
    "title": "DO-299173",
    "custom_order_number": "3899 Mayberry",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "419.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "441.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T09:35:31.000Z",
    "created_at": "2017-01-20T09:06:19.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299174,
    "title": "DO-299174",
    "custom_order_number": "2370",
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "7.0",
    "subtotal": "266.0",
    "dealer_discount": "13.3",
    "total_discount": "114.38",
    "tax": "31.72",
    "grand_total": "190.34",
    "deposit_percentage": 0,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T09:20:58.000Z",
    "created_at": "2017-01-20T09:14:48.000Z",
    "invoiced_at": "2017-03-01T08:56:14.000Z",
    "currency": {
      "name": "GBP",
      "symbol": "£",
      "rate": "0.625"
    }
  },
  {
    "id": 299175,
    "title": "DO-299175",
    "custom_order_number": null,
    "garment_count": 3,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "242.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "253.0",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T09:39:03.000Z",
    "created_at": "2017-01-20T09:16:31.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299176,
    "title": "DO-299176",
    "custom_order_number": "1181147/Nianick/HP",
    "garment_count": 4,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "274.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "285.0",
    "deposit_percentage": 50,
    "current_balance": "285.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2017-01-20T09:57:49.000Z",
    "created_at": "2017-01-20T09:17:31.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299177,
    "title": "DO-299177",
    "custom_order_number": "2369",
    "garment_count": 2,
    "ship_type": "Ground",
    "ship_cost": "14.0",
    "subtotal": "570.15",
    "dealer_discount": "28.51",
    "total_discount": "28.51",
    "tax": "111.13",
    "grand_total": "666.77",
    "deposit_percentage": 0,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-20T09:37:29.000Z",
    "created_at": "2017-01-20T09:23:16.000Z",
    "invoiced_at": "2017-03-08T10:26:26.000Z",
    "currency": {
      "name": "GBP",
      "symbol": "£",
      "rate": "0.625"
    }
  },
  {
    "id": 299178,
    "title": "DO-299178",
    "custom_order_number": "0000008",
    "garment_count": 4,
    "ship_type": "Ground",
    "ship_cost": "22.0",
    "subtotal": "424.5",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "446.5",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-01-27T14:55:00.000Z",
    "created_at": "2017-01-20T09:25:54.000Z",
    "invoiced_at": "2017-03-23T16:08:40.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299180,
    "title": "DO-299180",
    "custom_order_number": "1181502/Moramarco/DC",
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "494.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "505.0",
    "deposit_percentage": 50,
    "current_balance": "505.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2017-01-20T09:40:38.000Z",
    "created_at": "2017-01-20T09:33:01.000Z",
    "invoiced_at": null,
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  },
  {
    "id": 299181,
    "title": "DO-299181",
    "custom_order_number": null,
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "11.0",
    "subtotal": "379.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "390.0",
    "deposit_percentage": 50,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2017-03-22T10:08:45.000Z",
    "created_at": "2017-01-20T09:33:08.000Z",
    "invoiced_at": "2017-04-14T13:37:27.000Z",
    "currency": {
      "name": "USD",
      "symbol": "$",
      "rate": "1.0"
    }
  }
]

Returns an array of dealer orders (DOs).

HTTP Request

GET https://api.trinity-apparel.com/v1/orders

Query Parameters

Parameter Default Description
customer_id N/A If set, the result will only include orders from this customer id.
is_active true If set to true, the result will only include active fabrics.
extended false If set to true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Order Metrics

curl "https://api.trinity-apparel.com/v1/orders/metrics"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "delays": 2,
  "incompletes": 1
}

Returns the total delays and incompletes for a dealer.

Query Parameters

Parameter Default Description
customer_id N/A If set, the result will only include orders from this customer

Other

Get a Specific Order

curl "https://api.trinity-apparel.com/v1/orders/399780"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 399780,
  "title": "DO-399780",
  "custom_order_number": null,
  "garment_count": 7,
  "ship_type": "In-Store Pick-Up",
  "ship_cost": "0.0",
  "subtotal": "2554.0",
  "dealer_discount": "0.0",
  "total_discount": "0.0",
  "tax": "0.0",
  "grand_total": "2554.0",
  "deposit_percentage": 50,
  "current_balance": "2554.0",
  "measurement_units": "uscust",
  "payment_status": "offline",
  "ordered_at": "2018-06-29T10:55:15.000Z",
  "created_at": "2018-06-29T09:42:51.000Z",
  "invoiced_at": null,
  "order_type": "MTM",
  "order_source": "workflo",
  "currency": {
    "name": "USD",
    "symbol": "$",
    "rate": "1.0"
  },
  "shipping_address": {
    "id": 1477,
    "description": "Trinity",
    "street1": "193 Business Park Dr",
    "street2": null,
    "street3": null,
    "city": "Ridgeland",
    "state": "MS",
    "zip": "39157",
    "country": "USA",
    "phone": null
  },
  "factory_address": {
    "id": 1,
    "description": "Trinity USA",
    "street1": "227 Marketridge Dr",
    "street2": null,
    "street3": null,
    "city": "Ridgeland",
    "state": "MS",
    "zip": "39157",
    "country": "USA",
    "phone": "601-713-2628"
  },
  "dealer": {
    "id": 1106,
    "name": "Studio Garments",
    "first_name": "Studio",
    "last_name": "Garments",
    "company_name": null,
    "email": "jwiggins@idpbp.com",
    "phone": "6017132628",
    "country": "USA"
  },
  "customer": {
    "id": 87285,
    "created_at": "2016-05-29T15:08:38.000Z",
    "name": "Mr Mannequin",
    "first_name": "Mr",
    "last_name": "Mannequin",
    "email": null
  },
  "garments": [
    {
      "id": 872898,
      "title": "ID-872898",
      "order_id": 399780,
      "copied_garment_id": null,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T09:44:15.000Z",
      "updated_at": "2018-08-03T04:01:21.000Z"
    },
    {
      "id": 872909,
      "title": "ID-872909",
      "order_id": 399780,
      "copied_garment_id": 872898,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:02:12.000Z",
      "updated_at": "2018-07-27T03:35:22.000Z"
    },
    {
      "id": 872918,
      "title": "ID-872918",
      "order_id": 399780,
      "copied_garment_id": 872909,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:20:23.000Z",
      "updated_at": "2018-07-25T04:05:58.000Z"
    },
    {
      "id": 872919,
      "title": "ID-872919",
      "order_id": 399780,
      "copied_garment_id": 872898,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:26:58.000Z",
      "updated_at": "2018-07-23T03:51:47.000Z"
    },
    {
      "id": 872920,
      "title": "ID-872920",
      "order_id": 399780,
      "copied_garment_id": 872918,
      "price": "460.0",
      "option_cost": "60.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:30:15.000Z",
      "updated_at": "2018-07-26T03:38:01.000Z"
    },
    {
      "id": 872932,
      "title": "ID-872932",
      "order_id": 399780,
      "copied_garment_id": 872920,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:45:08.000Z",
      "updated_at": "2018-07-23T03:51:40.000Z"
    },
    {
      "id": 872933,
      "title": "ID-872933",
      "order_id": 399780,
      "copied_garment_id": 872932,
      "price": "274.0",
      "option_cost": "65.0",
      "garment_type": "CSC",
      "created_at": "2018-06-29T10:48:38.000Z",
      "updated_at": "2018-07-23T03:51:45.000Z"
    }
  ]
}

Returns details on a specific order and a snapshot of the garments within the order.

HTTP Request

GET https://api.trinity-apparel.com/v1/orders/:id

Query Parameters

Parameter Default Description
id N/A The specific order id you want to see

Other

Get All Garments

curl "https://api.trinity-apparel.com/v1/garments"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 892902,
    "title": "ID-892902",
    "order_id": 407781,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-17T09:50:45.000Z",
    "updated_at": "2018-08-29T03:52:13.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 407781,
      "title": "DO-407781",
      "custom_order_number": null,
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "416.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "416.0",
      "deposit_percentage": 50,
      "current_balance": "416.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-08-17T09:54:23.000Z",
      "created_at": "2018-08-09T10:41:20.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 892263,
    "title": "ID-892263",
    "order_id": 408973,
    "copied_garment_id": 856350,
    "price": "90.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-15T16:43:09.000Z",
    "updated_at": "2018-08-15T16:43:09.000Z",
    "order_status": {
      "code": "INCOMPLETE",
      "name": "Incomplete",
      "description": "Incomplete"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 408973,
      "title": "DO-408973",
      "custom_order_number": "",
      "garment_count": 0,
      "ship_type": "Ground",
      "ship_cost": "0.0",
      "subtotal": "0.0",
      "dealer_discount": "0.0",
      "total_discount": null,
      "tax": "0.0",
      "grand_total": "0.0",
      "deposit_percentage": 100,
      "current_balance": "0.0",
      "measurement_units": "uscust",
      "payment_status": "incomplete",
      "ordered_at": null,
      "created_at": "2018-08-15T16:41:14.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 895396,
    "title": "ID-895396",
    "order_id": 410469,
    "copied_garment_id": 888670,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-23T16:34:03.000Z",
    "updated_at": "2018-09-06T02:46:09.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 410469,
      "title": "DO-410469",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "504.5",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "504.5",
      "deposit_percentage": 50,
      "current_balance": "504.5",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-08-23T16:40:53.000Z",
      "created_at": "2018-08-23T16:20:26.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 895401,
    "title": "ID-895401",
    "order_id": 410469,
    "copied_garment_id": 895396,
    "price": "54.0",
    "option_cost": "4.5",
    "garment_type": "CSHT",
    "created_at": "2018-08-23T16:39:55.000Z",
    "updated_at": "2018-09-06T02:46:02.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 410469,
      "title": "DO-410469",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "504.5",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "504.5",
      "deposit_percentage": 50,
      "current_balance": "504.5",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-08-23T16:40:53.000Z",
      "created_at": "2018-08-23T16:20:26.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 896118,
    "title": "ID-896118",
    "order_id": 410677,
    "copied_garment_id": null,
    "price": "85.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-27T09:58:53.000Z",
    "updated_at": "2018-09-06T02:45:58.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 410677,
      "title": "DO-410677",
      "custom_order_number": null,
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "745.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "745.0",
      "deposit_percentage": 50,
      "current_balance": "745.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-08-27T10:16:22.000Z",
      "created_at": "2018-08-24T16:17:43.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 897997,
    "title": "ID-897997",
    "order_id": 411784,
    "copied_garment_id": null,
    "price": "75.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-08-30T14:29:48.000Z",
    "updated_at": "2018-09-11T03:38:42.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 411784,
      "title": "DO-411784",
      "custom_order_number": null,
      "garment_count": 1,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "75.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "75.0",
      "deposit_percentage": 50,
      "current_balance": "75.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-08-30T14:39:11.000Z",
      "created_at": "2018-08-30T14:22:12.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 899861,
    "title": "ID-899861",
    "order_id": 412640,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "10.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-05T11:23:57.000Z",
    "updated_at": "2018-09-10T02:21:23.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 412640,
      "title": "DO-412640",
      "custom_order_number": "photo shoot samples",
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "676.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "676.0",
      "deposit_percentage": 50,
      "current_balance": "676.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-05T15:45:42.000Z",
      "created_at": "2018-09-05T11:04:38.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 905041,
    "title": "ID-905041",
    "order_id": 412892,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-17T09:43:02.000Z",
    "updated_at": null,
    "order_status": {
      "code": "INCOMPLETE",
      "name": "Incomplete",
      "description": "Incomplete"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 412892,
      "title": "DO-412892",
      "custom_order_number": "",
      "garment_count": 0,
      "ship_type": "Ground",
      "ship_cost": "0.0",
      "subtotal": "0.0",
      "dealer_discount": "0.0",
      "total_discount": null,
      "tax": "0.0",
      "grand_total": "0.0",
      "deposit_percentage": 100,
      "current_balance": "0.0",
      "measurement_units": "uscust",
      "payment_status": "incomplete",
      "ordered_at": null,
      "created_at": "2018-09-06T10:36:15.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 902379,
    "title": "ID-902379",
    "order_id": 413845,
    "copied_garment_id": null,
    "price": "71.0",
    "option_cost": "4.5",
    "garment_type": "CSHT",
    "created_at": "2018-09-11T14:36:26.000Z",
    "updated_at": "2018-09-18T03:10:01.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 413845,
      "title": "DO-413845",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "710.5",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "710.5",
      "deposit_percentage": 50,
      "current_balance": "710.5",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-11T14:39:53.000Z",
      "created_at": "2018-09-11T14:21:09.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 904299,
    "title": "ID-904299",
    "order_id": 414761,
    "copied_garment_id": 892902,
    "price": "71.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-14T14:22:11.000Z",
    "updated_at": "2018-09-25T03:49:35.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 414761,
      "title": "DO-414761",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "198.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "198.0",
      "deposit_percentage": 50,
      "current_balance": "198.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-14T14:34:48.000Z",
      "created_at": "2018-09-14T14:21:04.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 904303,
    "title": "ID-904303",
    "order_id": 414761,
    "copied_garment_id": 892902,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-14T14:25:48.000Z",
    "updated_at": "2018-09-25T03:50:02.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 414761,
      "title": "DO-414761",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "198.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "198.0",
      "deposit_percentage": 50,
      "current_balance": "198.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-14T14:34:48.000Z",
      "created_at": "2018-09-14T14:21:04.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 904305,
    "title": "ID-904305",
    "order_id": 414761,
    "copied_garment_id": 904303,
    "price": "61.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-14T14:29:07.000Z",
    "updated_at": "2018-09-25T03:49:30.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 414761,
      "title": "DO-414761",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "198.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "198.0",
      "deposit_percentage": 50,
      "current_balance": "198.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-14T14:34:48.000Z",
      "created_at": "2018-09-14T14:21:04.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 904374,
    "title": "ID-904374",
    "order_id": 414783,
    "copied_garment_id": 895396,
    "price": "66.0",
    "option_cost": "4.5",
    "garment_type": "CSHT",
    "created_at": "2018-09-14T15:58:21.000Z",
    "updated_at": "2018-09-25T03:52:14.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 414783,
      "title": "DO-414783",
      "custom_order_number": null,
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "146.5",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "146.5",
      "deposit_percentage": 50,
      "current_balance": "146.5",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-14T16:03:13.000Z",
      "created_at": "2018-09-14T15:57:53.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 904376,
    "title": "ID-904376",
    "order_id": 414783,
    "copied_garment_id": 895396,
    "price": "76.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-14T16:00:52.000Z",
    "updated_at": "2018-09-27T03:31:31.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 414783,
      "title": "DO-414783",
      "custom_order_number": null,
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "146.5",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "146.5",
      "deposit_percentage": 50,
      "current_balance": "146.5",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-09-14T16:03:13.000Z",
      "created_at": "2018-09-14T15:57:53.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 910833,
    "title": "ID-910833",
    "order_id": 417697,
    "copied_garment_id": null,
    "price": "76.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-09-29T23:10:18.000Z",
    "updated_at": null,
    "order_status": {
      "code": "INCOMPLETE",
      "name": "Incomplete",
      "description": "Incomplete"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 417697,
      "title": "DO-417697",
      "custom_order_number": null,
      "garment_count": 0,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "0.0",
      "dealer_discount": "0.0",
      "total_discount": null,
      "tax": "0.0",
      "grand_total": "0.0",
      "deposit_percentage": 50,
      "current_balance": "0.0",
      "measurement_units": "uscust",
      "payment_status": "incomplete",
      "ordered_at": null,
      "created_at": "2018-09-29T22:59:50.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 912228,
    "title": "ID-912228",
    "order_id": 418267,
    "copied_garment_id": 856350,
    "price": "90.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-02T16:38:48.000Z",
    "updated_at": "2018-10-23T03:38:52.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418267,
      "title": "DO-418267",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "745.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "745.0",
      "deposit_percentage": 50,
      "current_balance": "745.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-05T15:33:18.000Z",
      "created_at": "2018-10-02T16:17:51.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 912231,
    "title": "ID-912231",
    "order_id": 418267,
    "copied_garment_id": 856347,
    "price": "75.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-02T16:40:35.000Z",
    "updated_at": "2018-10-18T03:15:45.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418267,
      "title": "DO-418267",
      "custom_order_number": null,
      "garment_count": 3,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "745.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "745.0",
      "deposit_percentage": 50,
      "current_balance": "745.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-05T15:33:18.000Z",
      "created_at": "2018-10-02T16:17:51.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 913375,
    "title": "ID-913375",
    "order_id": 418457,
    "copied_garment_id": null,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-04T15:30:18.000Z",
    "updated_at": null,
    "order_status": {
      "code": "INCOMPLETE",
      "name": "Incomplete",
      "description": "Incomplete"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418457,
      "title": "DO-418457",
      "custom_order_number": "",
      "garment_count": 0,
      "ship_type": "Ground",
      "ship_cost": "0.0",
      "subtotal": "0.0",
      "dealer_discount": "0.0",
      "total_discount": null,
      "tax": "0.0",
      "grand_total": "0.0",
      "deposit_percentage": 100,
      "current_balance": "0.0",
      "measurement_units": "uscust",
      "payment_status": "incomplete",
      "ordered_at": null,
      "created_at": "2018-10-03T13:26:13.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 913251,
    "title": "ID-913251",
    "order_id": 418746,
    "copied_garment_id": 878112,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-04T13:52:18.000Z",
    "updated_at": "2018-10-15T03:36:23.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418746,
      "title": "DO-418746",
      "custom_order_number": null,
      "garment_count": 6,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "644.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "644.0",
      "deposit_percentage": 50,
      "current_balance": "644.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-04T13:59:15.000Z",
      "created_at": "2018-10-04T13:50:37.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 913254,
    "title": "ID-913254",
    "order_id": 418746,
    "copied_garment_id": 913251,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-04T13:52:55.000Z",
    "updated_at": "2018-10-15T03:32:50.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418746,
      "title": "DO-418746",
      "custom_order_number": null,
      "garment_count": 6,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "644.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "644.0",
      "deposit_percentage": 50,
      "current_balance": "644.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-04T13:59:15.000Z",
      "created_at": "2018-10-04T13:50:37.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 913255,
    "title": "ID-913255",
    "order_id": 418746,
    "copied_garment_id": 913254,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-04T13:53:40.000Z",
    "updated_at": "2018-10-15T03:32:49.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418746,
      "title": "DO-418746",
      "custom_order_number": null,
      "garment_count": 6,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "644.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "644.0",
      "deposit_percentage": 50,
      "current_balance": "644.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-04T13:59:15.000Z",
      "created_at": "2018-10-04T13:50:37.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 913263,
    "title": "ID-913263",
    "order_id": 418746,
    "copied_garment_id": 913255,
    "price": "66.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-04T13:56:50.000Z",
    "updated_at": "2018-10-15T03:32:48.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 418746,
      "title": "DO-418746",
      "custom_order_number": null,
      "garment_count": 6,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "644.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "644.0",
      "deposit_percentage": 50,
      "current_balance": "644.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-04T13:59:15.000Z",
      "created_at": "2018-10-04T13:50:37.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 915901,
    "title": "ID-915901",
    "order_id": 420034,
    "copied_garment_id": null,
    "price": "109.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-10T14:48:27.000Z",
    "updated_at": "2018-10-26T02:59:40.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 420034,
      "title": "DO-420034",
      "custom_order_number": null,
      "garment_count": 1,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "109.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "109.0",
      "deposit_percentage": 50,
      "current_balance": "109.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-10T15:06:28.000Z",
      "created_at": "2018-10-10T14:46:24.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 918812,
    "title": "ID-918812",
    "order_id": 421405,
    "copied_garment_id": null,
    "price": "55.0",
    "option_cost": "10.0",
    "garment_type": "CSHT",
    "created_at": "2018-10-17T12:18:47.000Z",
    "updated_at": "2018-10-31T02:50:32.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 421405,
      "title": "DO-421405",
      "custom_order_number": null,
      "garment_count": 1,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "65.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "65.0",
      "deposit_percentage": 50,
      "current_balance": "65.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-17T12:26:45.000Z",
      "created_at": "2018-10-17T12:17:56.000Z",
      "invoiced_at": null
    }
  },
  {
    "id": 919662,
    "title": "ID-919662",
    "order_id": 421718,
    "copied_garment_id": null,
    "price": "109.0",
    "option_cost": "4.5",
    "garment_type": "CSHT",
    "created_at": "2018-10-18T15:23:42.000Z",
    "updated_at": "2018-10-29T03:09:48.000Z",
    "order_status": {
      "code": "SHIPCUST",
      "name": "Delivery",
      "description": "Delivery"
    },
    "delay_status": {
      "code": "OK",
      "description": "Not Delayed"
    },
    "dealer_order": {
      "id": 421718,
      "title": "DO-421718",
      "custom_order_number": null,
      "garment_count": 2,
      "ship_type": "In-Store Pick-Up",
      "ship_cost": "0.0",
      "subtotal": "227.0",
      "dealer_discount": "0.0",
      "total_discount": "0.0",
      "tax": "0.0",
      "grand_total": "227.0",
      "deposit_percentage": 50,
      "current_balance": "218.0",
      "measurement_units": "uscust",
      "payment_status": "offline",
      "ordered_at": "2018-10-18T15:35:38.000Z",
      "created_at": "2018-10-18T12:49:16.000Z",
      "invoiced_at": null
    }
  }
]

Returns an array of garments. Each garment will have pricing information and order status information.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments

Query Parameters

Parameter Default Description
customer_id N/A Show garments for a specific customer.
order_id N/A Show garments that are part of a specific dealer order.
order_status_code N/A Show garments that are in a specific order status.
delay_status_code N/A Show garments that are in a specific delay status.
extended false If set to true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Get a Specific Garment

curl "https://api.trinity-apparel.com/v1/garments/399780"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 892902,
  "title": "ID-892902",
  "order_id": 407781,
  "copied_garment_id": null,
  "price": "66.0",
  "option_cost": "0.0",
  "garment_type": "CSHT",
  "created_at": "2018-08-17T09:50:45.000Z",
  "updated_at": "2018-08-29T03:52:13.000Z",
  "prefix": "ID",
  "index": "2/2",
  "last_status_change_date": "2018-09-14T14:20:40.000Z",
  "last_delay_change_date": null,
  "order_status": {
    "code": "SHIPCUST",
    "name": "Delivery",
    "description": "Delivery"
  },
  "delay_status": {
    "code": "OK",
    "description": "Not Delayed"
  },
  "dealer_order": {
    "id": 407781,
    "title": "DO-407781",
    "custom_order_number": null,
    "garment_count": 2,
    "ship_type": "In-Store Pick-Up",
    "ship_cost": "0.0",
    "subtotal": "416.0",
    "dealer_discount": "0.0",
    "total_discount": "0.0",
    "tax": "0.0",
    "grand_total": "416.0",
    "deposit_percentage": 50,
    "current_balance": "416.0",
    "measurement_units": "uscust",
    "payment_status": "offline",
    "ordered_at": "2018-08-17T09:54:23.000Z",
    "created_at": "2018-08-09T10:41:20.000Z",
    "invoiced_at": null
  },
  "manufacturer": {
    "id": 2,
    "address_id": 1943,
    "name": "iD Shirts",
    "email": "info@trinity-apparel.com"
  },
  "fabric": {
    "id": 27284,
    "active": true,
    "description": "White Fine Twill",
    "supplier_fabric_number": "#12 White",
    "trinity_fabric_number": "N3-3127284",
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/N3-3127284",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=N3-3127284&res=300"
  }
}

Returns details on a specific garment.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id

Query Parameters

Parameter Default Description
id N/A The specific garment id you want to see

Other

Get Garment Ship Destination

curl -X POST "https://api.trinity-apparel.com/v1/garments/:id/destination"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "rack_code": "1058-001",
    "shipping_class": "bulk"
  }
]

Returns the rack code and shipping class for a specified garment.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/destination

Query Parameters

Parameter Default Description
id N/A The specific garment id for which you want to see the destination information.

Shipping Classes

Rack Code

A rack code is a unique identifier for a customer's address. The first four digits of the code are the customer's unique identifier and the last three digits are the unique identifier for each of that customer's addresses. Garments entering the finished goods warehouse with the direct ship shipping class are recommended to be sorted by rack code. This is uncessary for garments with the bulk shipping class.

Other

Get All Garment Options

curl "https://api.trinity-apparel.com/v1/garments/966400/options"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 1,
      "name": "garment_label",
      "description": "Garment Label",
      "display_order": 5
    },
    "option_value": {
      "id": 4,
      "option_value": "no_label",
      "description": "No Label",
      "display_order": 2
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 2,
      "name": "vent_style",
      "description": "Vent Style",
      "display_order": 1
    },
    "option_value": {
      "id": 7,
      "option_value": "side_vent",
      "description": "Sides (9 1/2\") - Standard",
      "display_order": 6
    }
  },
  {
    "updated_at": "2019-02-12T16:38:47.000Z",
    "text": null,
    "option": {
      "id": 3,
      "name": "shoulder_style",
      "description": "Shoulder Style",
      "display_order": 1
    },
    "option_value": {
      "id": 656,
      "option_value": "ultra_soft",
      "description": "Ultra Soft",
      "display_order": 0
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 4,
      "name": "exterior_breast_pocket",
      "description": "Exterior Breast Pocket",
      "display_order": 1
    },
    "option_value": {
      "id": 730,
      "option_value": "welt_curved_square",
      "description": "Welt (Curved, Square Edges)",
      "display_order": 3
    }
  },
  {
    "updated_at": "2019-02-12T16:39:03.000Z",
    "text": null,
    "option": {
      "id": 5,
      "name": "ticket_pocket",
      "description": "Ticket Pocket",
      "display_order": 5
    },
    "option_value": {
      "id": 771,
      "option_value": "patch",
      "description": "Patch",
      "display_order": 15
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 6,
      "name": "exterior_lower_pockets",
      "description": "Exterior Lower Pockets",
      "display_order": 9
    },
    "option_value": {
      "id": 18,
      "option_value": "patch",
      "description": "Patch",
      "display_order": 15
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 7,
      "name": "interior_breast_pocket_l",
      "description": "Interior Breast Pocket (L)",
      "display_order": 1
    },
    "option_value": {
      "id": 1299,
      "option_value": "double_besom",
      "description": "Double Besom",
      "display_order": 2
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 8,
      "name": "interior_breast_pocket_r",
      "description": "Interior Breast Pocket (R)",
      "display_order": 2
    },
    "option_value": {
      "id": 1357,
      "option_value": "double_besom",
      "description": "Double Besom",
      "display_order": 2
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 9,
      "name": "pen_pencil_pocket",
      "description": "Pen/Pencil Pocket",
      "display_order": 6
    },
    "option_value": {
      "id": 32,
      "option_value": "none",
      "description": "None",
      "display_order": 1
    }
  },
  {
    "updated_at": "2019-02-12T16:36:59.000Z",
    "text": null,
    "option": {
      "id": 10,
      "name": "cellphone_pocket",
      "description": "Cell Phone Pocket",
      "display_order": 5
    },
    "option_value": {
      "id": 33,
      "option_value": "right",
      "description": "Right",
      "display_order": 3
    }
  }
]

Returns an array of garment options and option values for a specific garment.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/options

Query Parameters

Parameter Default Description
id N/A The specific garment id you want to see the options for.

Other

Get All Garment Measurements

curl "https://api.trinity-apparel.com/v1/garments/890682/measurements"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0.000",
    "measurement": {
      "id": 7,
      "name": "perkins_incline",
      "description": "Incline Reading",
      "display_order": 5
    },
    "measurement_value": {
      "id": 16,
      "value": "0.000",
      "description": "",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0.000",
    "measurement": {
      "id": 9,
      "name": "perkins_shoulder_l",
      "description": "Shoulder Reading (L)",
      "display_order": 6
    },
    "measurement_value": {
      "id": 39,
      "value": "0.000",
      "description": "",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0.000",
    "measurement": {
      "id": 10,
      "name": "perkins_shoulder_r",
      "description": "Shoulder Reading (R)",
      "display_order": 7
    },
    "measurement_value": {
      "id": 51,
      "value": "0.000",
      "description": "",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "regular",
    "measurement": {
      "id": 11,
      "name": "perkins_shoulder_desc_l",
      "description": "Shoulder Desc (L)",
      "display_order": 8
    },
    "measurement_value": {
      "id": 65,
      "value": "regular",
      "description": "Regular",
      "display_order": 3
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "regular",
    "measurement": {
      "id": 12,
      "name": "perkins_shoulder_desc_r",
      "description": "Shoulder Desc (R)",
      "display_order": 9
    },
    "measurement_value": {
      "id": 71,
      "value": "regular",
      "description": "Regular",
      "display_order": 3
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "42",
    "measurement": {
      "id": 49,
      "name": "shirt_chest_base",
      "description": "Actual Chest",
      "display_order": 5
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "5",
    "measurement": {
      "id": 50,
      "name": "shirt_chest_fit",
      "description": "Chest Fit Allowance",
      "display_order": 6
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "47",
    "measurement": {
      "id": 51,
      "name": "shirt_chest_total",
      "description": "Chest Fit Total",
      "display_order": 7
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0",
    "measurement": {
      "id": 54,
      "name": "shirt_waist_total",
      "description": "Waist Fit Total",
      "display_order": 10
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "0",
    "measurement": {
      "id": 57,
      "name": "shirt_hips_total",
      "description": "Hips Fit Total",
      "display_order": 13
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "regular",
    "measurement": {
      "id": 58,
      "name": "shirt_armhole",
      "description": "Armhole/Sleeve Fit",
      "display_order": 14
    },
    "measurement_value": {
      "id": 13,
      "value": "regular",
      "description": "Regular",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "0",
    "measurement": {
      "id": 98,
      "name": "shirt_point_sleeve_l",
      "description": "Shoulder Point Sleeve Length (L)",
      "display_order": 0
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "0",
    "measurement": {
      "id": 99,
      "name": "shirt_point_sleeve_r",
      "description": "Shoulder Point Sleeve Length (R)",
      "display_order": 0
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "regular",
    "measurement": {
      "id": 122,
      "name": "gerber_armhole",
      "description": "Gerber Armhole",
      "display_order": 0
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "normal",
    "measurement": {
      "id": 123,
      "name": "posture",
      "description": "Posture",
      "display_order": 12
    },
    "measurement_value": {
      "id": 184,
      "value": "normal",
      "description": "Normal",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "normal",
    "measurement": {
      "id": 130,
      "name": "stomach_stature",
      "description": "Stomach Description",
      "display_order": 19
    },
    "measurement_value": {
      "id": 214,
      "value": "normal",
      "description": "Normal",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "normal",
    "measurement": {
      "id": 185,
      "name": "gerber_posture_shirt",
      "description": "Gerber Posture (Shirt)",
      "display_order": 0
    },
    "measurement_value": {
      "id": 440,
      "value": "normal",
      "description": "Normal",
      "display_order": 0
    }
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "fold",
    "measurement": {
      "id": 220,
      "name": "gerber_layout",
      "description": "Gerber Layout",
      "display_order": 0
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "3",
    "measurement": {
      "id": 267,
      "name": "swacket_chest",
      "description": "Chest",
      "display_order": 0
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:27.000Z",
    "text": "none",
    "measurement": {
      "id": 271,
      "name": "shirt_elbow_forearm_reduction",
      "description": "Elbow/Forearm Reduction",
      "display_order": 15
    },
    "measurement_value": {
      "id": 602,
      "value": "none",
      "description": "None",
      "display_order": 1
    }
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "-0.5",
    "measurement": {
      "id": 278,
      "name": "estimated_finished_thigh",
      "description": "Estimated Finished Thigh",
      "display_order": 8
    },
    "measurement_value": null
  },
  {
    "updated_at": "2018-08-10T21:29:28.000Z",
    "text": "-0.5",
    "measurement": {
      "id": 279,
      "name": "estimated_u_rise",
      "description": "Estimated U Rise",
      "display_order": 5
    },
    "measurement_value": null
  }
]

Returns an array of garment measurements and measurement values for a specific garment.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/measurements

Query Parameters

Parameter Default Description
id N/A The specific garment id you want to see the measurements for.

Other

Get Order Statuses

curl "https://api.trinity-apparel.com/v1/order_statuses"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "code": "INCOMPLETE",
    "name": "Incomplete",
    "description": "Incomplete"
  },
  {
    "code": "CMTHOLD",
    "name": null,
    "description": "CMT Fabric Hold"
  },
  {
    "code": "FABHOLD",
    "name": "Restocking",
    "description": "Fabric Hold"
  },
  {
    "code": "SUBMITTED",
    "name": "Submitted",
    "description": "Ready"
  },
  {
    "code": "PENDING",
    "name": "Pending",
    "description": "Blue Pencil"
  },
  {
    "code": "PRODUCTION",
    "name": "Production",
    "description": "Production"
  },
  {
    "code": "MADE",
    "name": null,
    "description": "Production Complete"
  },
  {
    "code": "SHIPDC",
    "name": null,
    "description": "International Transit"
  },
  {
    "code": "INSPECTDC",
    "name": null,
    "description": "Final Inspection"
  },
  {
    "code": "PACKDC",
    "name": null,
    "description": "Shipment Processing"
  },
  {
    "code": "SHIPCUST",
    "name": "Delivery",
    "description": "Delivery"
  },
  {
    "code": "SHIPDIRECT",
    "name": null,
    "description": "Direct Ship"
  },
  {
    "code": "CANCEL",
    "name": null,
    "description": "Canceled"
  }
]

Returns a list of all order statuses

HTTP Request

GET https://api.trinity-apparel.com/v1/order_statuses

Query Parameters

None

Other

Get an Order Status

curl "https://api.trinity-apparel.com/v1/order_statuses/FABHOLD"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "code": "FABHOLD",
  "name": "Restocking",
  "description": "Fabric Hold",
  "max_delay_days": 9,
  "max_delay_days_shirts": 9,
  "max_delay_days_suits": 9,
  "is_active": true
}

Returns details on an order status

HTTP Request

GET https://api.trinity-apparel.com/v1/order_statuses/:code

Query Parameters

Parameter Default Description
code N/A The specific order status code

Other

Get Delay Statuses

curl "https://api.trinity-apparel.com/v1/delay_statuses"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "code": "OK",
    "description": "Not Delayed"
  },
  {
    "code": "FABRIC_OUT",
    "description": "Fabric Out"
  },
  {
    "code": "FABRIC_RECEIPT",
    "description": "Fabric Receipt Delay"
  },
  {
    "code": "FABRIC_DAMAGED",
    "description": "Fabric Flawed/Damaged"
  },
  {
    "code": "FABRIC_SHORT",
    "description": "Fabric Short"
  },
  {
    "code": "DEALER_INSTRUCT",
    "description": "Dealer Instruction Required"
  },
  {
    "code": "GARMENT_DAMAGED",
    "description": "Garment Damaged Delay"
  },
  {
    "code": "TRINITY_REVIEW",
    "description": "Trinity Review"
  },
  {
    "code": "DEALER_HOLD",
    "description": "Dealer Hold"
  },
  {
    "code": "CMT_SHELL",
    "description": "CMT Shell Fabric Delay"
  },
  {
    "code": "CMT_LINING",
    "description": "CMT Lining Fabric Delay"
  },
  {
    "code": "CMT_TRIM",
    "description": "CMT Trim Fabric Delay"
  },
  {
    "code": "PATTERN_REVIEW",
    "description": "Pattern Review"
  },
  {
    "code": "FACTORY_REVIEW",
    "description": "ID Review"
  }
]

Returns a list of all delay statuses

HTTP Request

GET https://api.trinity-apparel.com/v1/delay_statuses

Query Parameters

None

Other

Get a Delay Status

curl "https://api.trinity-apparel.com/v1/delay_statuses/FABRIC_OUT"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "code": "FABRIC_OUT",
  "description": "Fabric Out"
}

Returns details on a delay status. It doesn't provide that much information, as you can see.

HTTP Request

GET https://api.trinity-apparel.com/v1/delay_statuses/:code

Query Parameters

Parameter Default Description
code N/A The specific delay status code

Other

Measurements API

Measurement Resources

Measurement Group

Measurement groups are the groups/folders that contain measurements and alterations for a particular garment in Workflow. There are 12 measurement groups currently available.

# Standard Object - Used in a resource collection
{
    "id": 2,
    "name": "Body Description",
    "garment_type": 239,
    "display_order": 2
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the measurement group.
garment_type
integer
A bitmask for measurement availability by garment type. Click here for more info
display_order
integer
The order in which the measurement group is displayed in Workflow.

Measurement

A measurement for a garment. Typically these are set to a number (inches, pounds, etc) or a choice in a dropdown. There are over 200 currently available.

# Standard Object - Used in a resource collection
{
    "id": 16,
    "name": "coat_chest",
    "description": "Chest",
    "display_order": 3,
    "chinese_description": "胸围",
    "garment_type": 33,
    "convunit": 1,
    "required": true,
    "active": 1,
    "measurement_group": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the measurement.
description
string
A human readable description of the measurement.
chinese_description
string
A Chinese description of the measurement.
display_order
integer
The order in which the measurement is displayed in Workflow.
garment_type
integer
A bitmask for measurement availability by garment type. Click here for more info
convunit
boolean
Should this measurement be converted from inches to centimeters, etc?
required
boolean
Is the measurement required when ordering?
active
boolean
Is the measurement currently available for ordering?
measurement_group
subresource
The measurement is a part of a single measurement group

Measurement Value

A choice for a measurement. Example: the degree of sloping for posture. There are over 500 measurement values currently available.

# Standard Object - Used in a resource collection
{
    "id": 2,
    "value": "sloping",
    "description": "Sloping",
    "display_order": 2,
    "measurement": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
value
string
The system value for the measurement selection.
description
string
A human readable description of the measurement value.
display_order
integer
The order in which the measurement value is displayed in Workflow.
measurement
subresource
The measurement value is a choice for a measurement

Get All Measurement Groups

curl "https://api.trinity-apparel.com/v1/measurement_groups"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 1,
        "name": "General",
        "garment_type": 239,
        "display_order": 1
    },
    {
        "id": 2,
        "name": "Body Description",
        "garment_type": 239,
        "display_order": 2
    },
    {
        "id": 3,
        "name": "Coat",
        "garment_type": 35,
        "display_order": 3
    },
    {
        "id": 4,
        "name": "Vest",
        "garment_type": 2,
        "display_order": 4
    },
    {
        "id": 5,
        "name": "Pant",
        "garment_type": 231,
        "display_order": 5
    },
    {
        "id": 6,
        "name": "Shirt",
        "garment_type": 8,
        "display_order": 6
    },
    {
        "id": 7,
        "name": "Coat Alterations",
        "garment_type": 33,
        "display_order": 7
    },
    {
        "id": 8,
        "name": "Pant Alterations",
        "garment_type": 196,
        "display_order": 9
    },
    {
        "id": 9,
        "name": "Shirt Alterations",
        "garment_type": 8,
        "display_order": 10
    },
    {
        "id": 10,
        "name": "Vest Alterations",
        "garment_type": 2,
        "display_order": 8
    },
    {
        "id": 11,
        "name": "Swacket",
        "garment_type": 512,
        "display_order": 11
    },
    {
        "id": 12,
        "name": "Topcoat",
        "garment_type": 32,
        "display_order": 1
    }
]

Returns an array of measurement groups.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurement_groups

Query Parameters

Parameter Default Description
garment_type N/A If set, returns all measurement groups that match a garment bitmask (E.g., 2 for Vests).

Other

Get a Specific Measurement Group

curl "https://api.trinity-apparel.com/v1/measurement_groups/4"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 3,
    "name": "Coat",
    "garment_type": 35,
    "display_order": 3
}

Returns details on a specific measurement group.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurement_groups/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Get All Measurements

curl "https://api.trinity-apparel.com/v1/measurements"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    ...,
    {
        "id": 16,
        "name": "coat_chest",
        "description": "Chest",
        "display_order": 3,
        "chinese_description": "胸围",
        "garment_type": 33,
        "convunit": 1,
        "required": true,
        "active": 1,
        "measurement_group": {
            "id": 3,
            "name": "Coat",
            "garment_type": 35,
            "display_order": 3
        }
    },
    {
        "id": 17,
        "name": "coat_half_back",
        "description": "1/2 Back",
        "display_order": 4,
        "chinese_description": "半背宽",
        "garment_type": 33,
        "convunit": 1,
        "required": false,
        "active": 1,
        "measurement_group": {
            "id": 3,
            "name": "Coat",
            "garment_type": 35,
            "display_order": 3
        }
    },
    {
        "id": 18,
        "name": "coat_waist",
        "description": "Coat Waist",
        "display_order": 5,
        "chinese_description": "上衣腰围",
        "garment_type": 35,
        "convunit": 1,
        "required": false,
        "active": 1,
        "measurement_group": {
            "id": 3,
            "name": "Coat",
            "garment_type": 35,
            "display_order": 3
        }
    },
    {
        "id": 19,
        "name": "coat_half_girth",
        "description": "1/2 Girth",
        "display_order": 6,
        "chinese_description": "中腰",
        "garment_type": 33,
        "convunit": 1,
        "required": true,
        "active": 1,
        "measurement_group": {
            "id": 3,
            "name": "Coat",
            "garment_type": 35,
            "display_order": 3
        }
    },
    ...
]

Returns an array of measurements.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurements

Query Parameters

Parameter Default Description
active N/A If set, returns only only active or inactive measurements.
q N/A If set, return all fuzzy matched measurement names and descriptions.
measurement_group_id N/A If set, will return any measurements in a specific measurement group.
garment_type N/A If set, returns all measurements that match a garment bitmask (E.g., 2 for Vests).

Other

Example queries

Ex. Search for measurements mentioning "girth"

GET https://api.trinity-apparel.com/v1/measurement?q=girth

Search by Garment Type

Ex. List pant measurements

GET https://api.trinity-apparel.com/v1/measurements?garment_type=4

Get a Specific Measurement

curl "https://api.trinity-apparel.com/v1/measurements/229"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 6,
    "name": "coat_fit",
    "description": "Coat Fit",
    "display_order": 4,
    "chinese_description": "成衣效果",
    "garment_type": 33,
    "convunit": 0,
    "required": true,
    "active": 1,
    "measurement_group": {
        "id": 2,
        "name": "Body Description",
        "garment_type": 239,
        "display_order": 2
    },
    "measurement_values": [
        {
            "id": 84,
            "value": "regular",
            "description": "Regular",
            "display_order": 1
        },
        {
            "id": 85,
            "value": "trim",
            "description": "Trim",
            "display_order": 2
        },
        {
            "id": 86,
            "value": "easy",
            "description": "Easy",
            "display_order": 3
        }
    ]
}

Returns details on a specific measurement, including the measurement group and any defined measurement values.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurements/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Get All Measurement Values

curl "https://api.trinity-apparel.com/v1/measurement_values"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    ...,
    {
        "id": 184,
        "value": "normal",
        "description": "Normal",
        "display_order": 1,
        "measurement": {
            "id": 123,
            "name": "posture",
            "description": "Posture",
            "display_order": 12
        }
    },
    {
        "id": 185,
        "value": "erect",
        "description": "Erect",
        "display_order": 2,
        "measurement": {
            "id": 123,
            "name": "posture",
            "description": "Posture",
            "display_order": 12
        }
    },
    {
        "id": 186,
        "value": "stooping",
        "description": "Stooping",
        "display_order": 3,
        "measurement": {
            "id": 123,
            "name": "posture",
            "description": "Posture",
            "display_order": 12
        }
    },
    {
        "id": 187,
        "value": "head_forward",
        "description": "Head Forward",
        "display_order": 4,
        "measurement": {
            "id": 123,
            "name": "posture",
            "description": "Posture",
            "display_order": 12
        }
    },
    {
        "id": 188,
        "value": "erect_slightly",
        "description": "Erect - Slightly (1/8\")",
        "display_order": 1,
        "measurement": {
            "id": 124,
            "name": "posture_amt",
            "description": "Posture Amount",
            "display_order": 13
        }
    },
    {
        "id": 189,
        "value": "erect_moderately",
        "description": "Erect - Moderately (3/8\")",
        "display_order": 2,
        "measurement": {
            "id": 124,
            "name": "posture_amt",
            "description": "Posture Amount",
            "display_order": 13
        }
    },
    {
        "id": 190,
        "value": "erect_maximum",
        "description": "Erect - Maximum (5/8\")",
        "display_order": 3,
        "measurement": {
            "id": 124,
            "name": "posture_amt",
            "description": "Posture Amount",
            "display_order": 13
        }
    },
    ...
]

Returns an array of measurement values.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurement_values

Query Parameters

Parameter Default Description
active N/A If set, returns only only active or inactive measurements.
q N/A If set, return all fuzzy matched measurement names and descriptions.
measurement_id N/A If set, will return any measurement values in a specific measurement
garment_type N/A If set, returns all measurement values that match a garment bitmask (E.g., 2 for Vests).

Other

Example queries

Wildcard Search

Ex. Search for measurement values mentioning "easy"

GET https://api.trinity-apparel.com/v1/measurement_values?q=easy

Search by Garment Type

Ex. List shirt measurement values

GET https://api.trinity-apparel.com/v1/measurement_values?garment_type=8

Search by Measurement

Ex. List all values for Perkins Posturegar

GET https://api.trinity-apparel.com/v1/measurement_values?measurement_id=8

Wildcard Search and Garment Type

Ex. List jacket measurement values that mentioning "stooping"

GET https://api.trinity-apparel.com/v1/measurement_values?garment_type=1&q=stooping

Get a Specific Measurement Value

curl "https://api.trinity-apparel.com/v1/measurement_values/10"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 10,
    "value": "extremely_sloping",
    "description": "Extremely Sloping",
    "display_order": 4,
    "measurement": {
        "id": 46,
        "name": "shirt_shoulder_desc_r",
        "description": "Shoulder Description (R)",
        "display_order": 2
    }
}

Returns details on a specific measurement value, which includes the parent measurement.

HTTP Request

GET https://api.trinity-apparel.com/v1/measurement_values/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Options API

Option Resources

Option Group

Option groups are the groups/folders that contain styling options for a particular garment in Workflow. There are 30 option groups currently available.

# Standard Object - Used in a resource collection
{
    "id": 27,
    "name": "Label Options",
    "garment_type": 623,
    "display_order": 230
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the option group.
garment_type
integer
A bitmask for option availability by garment type. Click here for more info
display_order
integer
The order in which the option group is displayed in Workflow.

Option

A styling option for a garment. Typically these are set to an option value, a fabric number, or a text field. There are 600+ options currently available.

# Standard Object - Used in a resource collection
{
    "id": 1,
    "name": "garment_label",
    "description": "Garment Label",
    "display_order": 5,
    "garment_type": 545,
    "option_location": "interior",
    "active": true,
    "option_group": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the option.
description
string
A human readable description of the option.
display_order
integer
The order in which the option is displayed in Workflow.
garment_type
integer
A bitmask for option availability by garment type. Click here for more info
location
string
High level grouping for options. Can be materials, interior, or exterior.
active
boolean
Is the option currently available for ordering?
option_group
subresource
The option is a part of a single option group

Option Value

A choice for a styling option. Example: a specific thread for sleeve button thread color. There are 11,000 option values currently available.

# Standard Object - Used in a resource collection
{
    "id": 1,
    "option_value": "trinity_label",
    "description": "Trinity Apparel Group",
    "display_order": 3,
    "active": true,
    "garment_type": 545,
    "default_value": false,
    "option": ... ,
    "manufacturer_option_values": [ ... ]
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the option.
description
string
A human readable description of the option.
display_order
integer
The order in which the option is displayed in Workflow.
garment_type
integer
A bitmask for option availability by garment type. Click here for more info
location
string
High level grouping for option values. Can be materials, interior, or exterior.
active
boolean
Is the option currently available for ordering?
option
subresource
The option value is a choice for a styling option

Manufacturer Option Value

Each option has a unique description for each manufacturer. This allows for language translations and factory specific information such as a button supplier number.

# Standard Object - Used in a resource collection
{
    "id": 17206,
    "locale": "zh",
    "description": "用Trinity商标",
    "chinese_description": "用Trinity商标"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
locale
string
A two character language code for the translation - Click here for more info
description
string
Human readable description of the material.
chinese_description
string
Human readable description of the material.

Get All Option Groups

curl "https://api.trinity-apparel.com/v1/option_groups"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 33,
        "name": "Inactive Options",
        "garment_type": 255,
        "display_order": 10
    },
    {
        "id": 40,
        "name": "Construction",
        "garment_type": 33,
        "display_order": 20
    },
    {
        "id": 39,
        "name": "Materials",
        "garment_type": 751,
        "display_order": 30
    },
    {
        "id": 25,
        "name": "Formal Options",
        "garment_type": 5,
        "display_order": 40
    },
    {
        "id": 15,
        "name": "Collar Options",
        "garment_type": 8,
        "display_order": 50
    },
    {
        "id": 1,
        "name": "Collar/Lapel Options",
        "garment_type": 547,
        "display_order": 60
    },
    {
        "id": 41,
        "name": "Front Options",
        "garment_type": 4,
        "display_order": 70
    },
    {
        "id": 42,
        "name": "Vest Front Options",
        "garment_type": 2,
        "display_order": 80
    },
    {
        "id": 9,
        "name": "Waistband Options",
        "garment_type": 196,
        "display_order": 90
    },
    ...
]

Returns an array of option groups.

HTTP Request

GET https://api.trinity-apparel.com/v1/option_groups

Query Parameters

Parameter Default Description
garment_type N/A If set, returns all option groups that match a garment bitmask (E.g., 2 for Vests).

Other

Get a Specific Option Group

curl "https://api.trinity-apparel.com/v1/option_groups/4"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 4,
    "name": "Button/Buttonhole Options",
    "garment_type": 751,
    "display_order": 170
}

Returns details on a specific option group.

HTTP Request

GET https://api.trinity-apparel.com/v1/option_groups/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Get All Options

curl "https://api.trinity-apparel.com/v1/options"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 1,
        "name": "garment_label",
        "description": "Garment Label",
        "display_order": 5,
        "garment_type": 545,
        "location": "interior",
        "active": true,
        "option_group": {
            "id": 27,
            "name": "Label Options",
            "garment_type": 623,
            "display_order": 230
        }
    },
    {
        "id": 2,
        "name": "vent_style",
        "description": "Vent Style",
        "display_order": 1,
        "garment_type": 33,
        "location": "exterior",
        "active": true,
        "option_group": {
            "id": 30,
            "name": "Vent Options",
            "garment_type": 33,
            "display_order": 120
        }
    },
    {
        "id": 3,
        "name": "shoulder_style",
        "description": "Shoulder Style",
        "display_order": 1,
        "garment_type": 33,
        "location": "exterior",
        "active": true,
        "option_group": {
            "id": 29,
            "name": "Shoulder Options",
            "garment_type": 35,
            "display_order": 100
        }
    },
    {
        "id": 4,
        "name": "exterior_breast_pocket",
        "description": "Exterior Breast Pocket",
        "display_order": 1,
        "garment_type": 545,
        "location": "exterior",
        "active": true,
        "option_group": {
            "id": 2,
            "name": "Pocket Options",
            "garment_type": 623,
            "display_order": 140
        }
    },
    ...
]

Returns an array of options.

HTTP Request

GET https://api.trinity-apparel.com/v1/options

Query Parameters

Parameter Default Description
active N/A If set, returns only only active or inactive options.
q N/A If set, return all fuzzy matched option names and descriptions.
option_group_id N/A If set, will return any options in a specific option group.
location N/A If set, returns all options in a specific location (E.g., exterior).
garment_type N/A If set, returns all options that match a garment bitmask (E.g., 2 for Vests).

Other

Example queries

Ex. Search for options mentioning "milanese"

GET https://api.trinity-apparel.com/v1/options?q=milanese

Search by Garment Type

Ex. List vest options

GET https://api.trinity-apparel.com/v1/options?garment_type=2

Search Option Group and Garment Type

Ex. List pocket options on a shirt

GET https://api.trinity-apparel.com/v1/options?option_group_id=2&garment_type=8

Get a Specific Option

curl "https://api.trinity-apparel.com/v1/options/229"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 229,
    "name": "lining_fabric_num",
    "description": "Lining Fabric #",
    "display_order": 110,
    "garment_type": 33,
    "location": "interior",
    "active": true,
    "option_group": {
        "id": 28,
        "name": "Interior Options",
        "garment_type": 545,
        "display_order": 250
    }
}

Returns details on a specific option.

HTTP Request

GET https://api.trinity-apparel.com/v1/options/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Get All Option Values

curl "https://api.trinity-apparel.com/v1/option_values"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 1,
        "option_value": "trinity_label",
        "description": "Trinity Apparel Group",
        "display_order": 3,
        "active": true,
        "garment_type": 545,
        "default_value": false,
        "option": {
            "id": 1,
            "name": "garment_label",
            "description": "Garment Label",
            "display_order": 5
        },
        "manufacturer_option_values": [
            {
                "id": 1,
                "locale": "zh",
                "description": "用Trinity 集团的布标",
                "chinese_description": "用Trinity 集团的布标"
            },
            {
                "id": 2,
                "locale": "zh",
                "description": "用Trinity 集团的布标",
                "chinese_description": "用Trinity 集团的布标"
            },
            {
                "id": 17206,
                "locale": "zh",
                "description": "用Trinity商标",
                "chinese_description": "用Trinity商标"
            }
        ]
    },
    ...,
    {
        "id": 4,
        "option_value": "no_label",
        "description": "No Label",
        "display_order": 2,
        "active": true,
        "garment_type": 545,
        "default_value": true,
        "option": {
            "id": 1,
            "name": "garment_label",
            "description": "Garment Label",
            "display_order": 5
        },
        "manufacturer_option_values": [
            {
                "id": 4,
                "locale": "zh",
                "description": "不使用布标",
                "chinese_description": "不使用布标"
            },
            {
                "id": 5,
                "locale": "zh",
                "description": "不使用布标",
                "chinese_description": "不使用布标"
            },
            {
                "id": 17207,
                "locale": "zh",
                "description": "无商标",
                "chinese_description": "无商标"
            },
            {
                "id": 26438,
                "locale": "id",
                "description": "No Customer Brand Label",
                "chinese_description": "No Label"
            }
        ]
    },
    {
        "id": 5,
        "option_value": "none",
        "description": "None",
        "display_order": 1,
        "active": true,
        "garment_type": 1,
        "default_value": false,
        "option": {
            "id": 2,
            "name": "vent_style",
            "description": "Vent Style",
            "display_order": 1
        },
        "manufacturer_option_values": [
            {
                "id": 7,
                "locale": "zh",
                "description": "无开叉",
                "chinese_description": "无开叉"
            },
            {
                "id": 8,
                "locale": "zh",
                "description": "无开叉",
                "chinese_description": "无开叉"
            },
            {
                "id": 17208,
                "locale": "zh",
                "description": "无开叉",
                "chinese_description": "无开叉"
            }
        ]
    },
    ...
]

Returns an array of option values.

HTTP Request

GET https://api.trinity-apparel.com/v1/option_values

Query Parameters

Parameter Default Description
active N/A If set, returns only only active or inactive options.
q N/A If set, return all fuzzy matched option names and descriptions.
option_id N/A If set, will return any option values in a specific option
garment_type N/A If set, returns all option values that match a garment bitmask (E.g., 2 for Vests).

Other

Example queries

Wildcard Search

Ex. Search for option values mentioning "buckle"

GET https://api.trinity-apparel.com/v1/option_values?q=buckle

Search by Garment Type

Ex. List topcoat option values

GET https://api.trinity-apparel.com/v1/option_values?garment_type=32

Search by Option

Ex. List all values for Exterior Breast Pocket

GET https://api.trinity-apparel.com/v1/option_values?option_id=4

Wildcard Search and Garment Type

Ex. List jacket option values that mentioning "ticket"

GET https://api.trinity-apparel.com/v1/option_values?q=ticket&garment_type=1

Get a Specific Option Value

curl "https://api.trinity-apparel.com/v1/option_values/10"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 10,
    "option_value": "welt",
    "description": "Welt (Standard)",
    "display_order": 2,
    "active": true,
    "garment_type": 545,
    "default_value": true,
    "option": {
        "id": 4,
        "name": "exterior_breast_pocket",
        "description": "Exterior Breast Pocket",
        "display_order": 1
    },
    "manufacturer_option_values": [
        {
            "id": 22,
            "locale": "zh",
            "description": "胸袋-内插袋",
            "chinese_description": "胸袋-内插袋"
        },
        {
            "id": 23,
            "locale": "zh",
            "description": "胸袋-内插袋",
            "chinese_description": "胸袋-内插袋"
        },
        {
            "id": 17213,
            "locale": "zh",
            "description": "手巾兜-标准",
            "chinese_description": "手巾兜-标准"
        },
        {
            "id": 26238,
            "locale": "id",
            "description": "OB Welt",
            "chinese_description": null
        }
    ]
}

Returns details on a specific option value, which include both the parent options and manufacturer descriptions.

HTTP Request

GET https://api.trinity-apparel.com/v1/option_values/:id

Query Parameters

Parameter Default Description
id. N/A The specific id you want to see

Other

Fabrics API

Fabric Resources

The Trinity Fabrics API provides detailed information on fabrics and collections. Collections are groups of fabrics. Here is a detailed list of attributes in those resources:

Fabric

# Standard Object - Used in a resource collection
{
    "id": 25600,
    "active": true,
    "description": "Fawn Solid",
    "supplier_fabric_number": "8427",
    "trinity_fabric_number": "U7-3025600",
    "collection_id": 1185,
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/U7-3025600",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=U7-3025600&res=300",
    "pattern_id": 1,
    "weave_id": null,
    "price_tier": 3,
    "discount": null,
    "has_image": false,
    "favorite_id": null,
    "fabric_garment_type": 199,
    "trim_garment_type": 0,
    "material_type": "Fabric",
    "factories": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
active
boolean
A fabric can be either active or inactive. Inactive fabrics are discontinued an will not appear in search results. Note: Historical orders made with a discontinued order will still show information about that fabric.
description
string
A description of the fabric - E.g., Blue Herringbone
supplier_fabric_number
string
A unique identifier / SKU according to the fabric supplier
trinity_fabric_number
string
A unique identifier / SKU according to Trinity
url
string
The url for a repeatable image of the fabric
swatch_url
string
The url for a swatch image of the fabric. This image contains serrated edges. Users can configure the zoom of the image by changing the res= parameter in the url to a different number.
pattern_id
integer
The unique ID for the pattern of the fabric.
weave_id
integer
The unique ID for the weave of the fabric.
price_tier
integer
If set, will be a ranking between 1-4 of how expensive the fabric is (1 being least expensive, 4 being most expensive).
discount
integer
If present, will be the percentage off the price of the fabric.
has_image
boolean
If true, the fabric image url will actually return an image of the fabric.
favorite_id
integer
If set, the fabric has been favorited by the client in fabrics explorer. ID can be used to unfavorite a fabric.
fabric_garment_type
integer
A bitmask describing what types of garments the fabric can be used for. See advanced queries.
trim_garment_type
integer
A bitmask describing what types of linings the fabric can be used for. See advanced queries.
material_type
string
A description of the material type usage of the fabric (fabric, lining, trim, etc)
factories
object
This includes the factory-specific information on a fabric. See below for more information.
# Extended Object
{
    "iD": {
        "in_stock": true,
        "restock_date": null,
        "last_edit_date": "2020-10-29T12:50:22.000Z",
        "readiness": "ship from vendor"
    },
    "T2iD": {
        "in_stock": true,
        "restock_date": null,
        "last_edit_date": "2020-10-29T12:50:22.000Z",
        "readiness": "at factory"
    }
}

Factories

Standard Attributes

Attribute Description
in_stock
boolean
Weather or not the fabric is available to order. If false, that means the fabric is temporarily out.
restock_date
datetime
The date a temporarily out of stock fabric will be restocked and available for orders. Most of the time this field is empty.
last_edit_date
datetime
The last time the fabric inventory level was changed.
readiness
string
One of: "At Factory", meaning the fabric is ready (4-5 week delivery for clothing, 2-3 week delivery for shirts), or "Ship From Vendor", meaning the fabric is not yet at the factory (5-6 weeks for clothing, 3-5 weeks for shirts).
# Extended Object
{
    "id": 61189,
    "active": true,
    "description": "Black solid",
    "supplier_fabric_number": "53145",
    "trinity_fabric_number": "XG-3861189",
    "collection_id": 1185,
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/XG-3861189",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=XG-3861189&res=300",
    "pattern_id": 1,
    "weave_id": null,
    "price_tier": 4,
    "discount": null,
    "has_image": false,
    "favorite_id": null,
    "fabric_garment_type": 231,
    "trim_garment_type": 0,
    "material_type": "Fabric",
    "factories": ...,
    "country_origin": "International",
    "fabric_grouping": "black",
    "pattern": "solid",
    "usage": "Garments",
    "fabric_year": 2019,
    "fabric_garment_types": ...,
    "trim_garment_types": ...,
    "weight": 212,
    "lead_time": "3 - 10 days",
    "alternate_images": ...,
    "related_trim": null,
    "collection": ...,
    "fabric_pattern": ...,
    "fabric_weave": ...,
    "price_code": ...,
    "supplier": ...,
    "composition": ...
}

Extended attributes

Attribute Description
country_origin
string
Where the fabric was milled.
fabric_grouping
string
Fabrics are typically grouped by dominant color.
usage
integer
The usage of the fabric (E.g., Shirt Trim, Clothing Trim, etc).
fabric_year
year
The year the fabric was released.
fabric_garment_types
subresource
An array of the garment types a fabric is used for.
trim_garment_types
subresource
An array of the garment types a trim is used for.
weight
integer
Weight in grams per square meter.
lead_time
string
If the fabric is in stock or the estimated time until it is in stock.
alternate_images
subresource
An array of alternate images for a fabric.
related_trim
subresource
A fabric subresource detailing the trim/lining related to the fabric.
collection
subresource
The collection in which the fabric was released.
fabric_pattern
subresource
Information about the pattern of a fabric, such as stripe, check, and solid.
fabric_weave
subresource
Information about the weave of a fabric.
price_code
subresource
Information about the price code for the fabric.
supplier
subresource
Information about the supplier of the fabric.
composition
subresource
The material composition of the fabric (E.g, 100% Wool).

Fabric Garment Types

# Standard Object - Used in a resource collection
[
    "CSC",
    "CV",
    "CT",
    "CSHO",
    "CBK"
]

Standard Attributes

Attribute Description

string
An array of strings that lists each garment type a fabric is valid for.

Trim Garment Types

# Standard Object - Used in a resource collection
[
    "CSC",
    "CV",
    "CT",
    "CSHO",
    "CBK"
]

Standard Attributes

Attribute Description

string
An array of strings that lists each garment type a trim is valid for.

Alternate Images

# Standard Object - Used in a resource collection
[
    {
        "name": "CSC",
        "description": "Jacket Laydown",
        "url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/CSC202-NT-4x4?&obj=CSC/Fabric&src=CMT-70001&res=300&obj=CSC/Buttons&color=43,43,43&obj=CSC/Thread/Thread&color=36,36,36&obj=CSCLining&src=LL-2617432&obj=CSC/Fabric/Lapel&src=CMT-70001&res=300&obj=CSC/Fabric/Collar&src=CMT-70001&res=300&obj=CSC/Fabric/Pockets/Breast_PKT&src=CMT-70001&res=300&obj=CSC/Fabric/Pkt_Cordingsrc=CMT-70001&res=300"
    },
    {
        "name": "CV",
        "description": "Vest Laydown",
        "url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/CV2-LINED-2x3?&obj=CV/Fabric&src=CMT-70001&res=300&obj=CV/Buttons&color=37,37,49&obj=CV/Thread&color=28,33,50&obj=CV/Liningsrc=LL-2617432&res=300&wid=200"
    },
    {
        "name": "CT",
        "description": "Trouser Laydown",
        "url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/CT-T0-OW-2X3?&obj=CT/Fabric&src=CMT-70001&res=300&obj=CT/Buttons&color=37,37,49&obj=CT/Thread&color=28,33,50&wid=200"
    },
    {
        "name": "CSHT",
        "description": "Shirt Laydown",
        "url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/CSHT-AS-FC4AMF-4x4?&obj=CSHT/Fabric&src=CMT-70001&res=300&obj=CSHT/Buttons&color=235,230,214&obj=CSHT/Thread&color=244,241,244obj=CSHT/Fabric/Neckband_In&src=CMT-70001&res=300&obj=CSHT/Fabric/Collar&src=CMT-70001&res=300&obj=CSHT/Fabric/Yoke_In&src=CMT-70001&res=300&obj=CSHT/Fabric/Cuff_Out&src=CMT-70001&res=300obj=CSHT/Fabric/Fronts/Placket&src=CMT-70001&res=300"
    }
]

Standard Attributes

Attribute Description
name
string
The garment type used in the alternate image.
description
string
A human readable description of the alternate image.
url
integer
The url for the image itself.

Pattern

# Standard Object - Used in a resource collection
{
    "id": 3,
    "name": "check",
    "position": 3,
    "parent_pattern_id": null
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the pattern.
position
integer
The ordering of the pattern in a list.
parent_pattern_id
integer
Points to a higher level grouping of patterns, such as checks. For example, a child could be Club Check.

Weave

# Standard Object - Used in a resource collection
{
    "id": 4,
    "name": "poplin",
    "position": 4,
    "parent_weave_id": null
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The name of the weave.
position
integer
The ordering of the weave in a list.
parent_weave_id
integer
Points to a higher level grouping of weaves

Price Code

# Standard Object - Used in a resource collection
{
    "code": "S2",
    "description": "Soktas Bespoke",
    "tier": 3
}

Standard Attributes

Attribute Description
code
string
Unique identifier for the object.
description
string
A human readable description of the price code.
tier
integer
If set, will be a ranking between 1-4 of how expensive the fabric is (1 being least expensive, 4 being most expensive).

Collection

# Standard Object - Used in a resource collection
{
    "id": 1309,
    "name": "Derby Performance Cornerstone Suitings V17011",
    "title": "Derby Performance Cornerstone Suitings",
    "datecode": "V17011",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/Derby_Performance_Cornerstone_Suitings_V17011?&hei=100",
    "digital_pdf_url": "https://workflow.trinity-apparel.com/share/view_document.php?use_ltype=trinity&document_id=281&download=1&filename=Derby_Performance_Cornerstone_V17011.pdf"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
name
string
The title of the collection
title
string
The name of the collection without the datecode.
datecode
string
The datecode of the collection (E.g., v18011). The first two digits are the year (2018), the next two are the month (01 = January), and the last one is which release we did during that month (1 = first).
image
string
URL to a thumbnail image for the collection. Image size is 105x100 px.
digital_pdf_url
string
URL to a pdf booklet of the collection.
# Extended Object
```json
{
    "id": 1854,
    "name": "Outerwear V18082",
    "title": "Outerwear",
    "datecode": "V18082",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/Outerwear_V18082?&hei=100",
    "digital_pdf_url": "https://trinity-apparel.s3.amazonaws.com/assets/digital_collection_outerwear_18082.pdf",
    "description": "",
    "fabrics": [...]
}

Extended attributes (in addition to standard attributes)

Attribute Description
description
string
A one to two paragraph descripton of the collection.
fabrics
subresource
A list of all fabrics that are a part of the collection. NOTE: Inactive fabrics may be shown

Supplier

# Standard Object - Used in a resource collection
{
    "id": 481,
    "code": "FW",
    "name": "Supplier",
    "city": "Springdale",
    "state": "Arkansas",
    "country": "USA"
}

Standard Attributes

Attribute Description
id
string
Unique identifier for the object.
code
string
The abbreviated name for a supplier.
name
string
The name of the supplier.
city
string
The city of the supplier's address.
state
string
The state of the supplier's address.
country
string
The country of the supplier's address.

Composition

# Standard Object - Used in a resource collection
{
    "id": 13,
    "description": "100% Cotton"
}

Standard Attributes

Attribute Description
id
string
Unique identifier for the object
description
string
A brief description of the fabric composition

Get All Collections

curl "https://api.trinity-apparel.com/v1/collections"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 2,
    "name": "07 FW Bellagio",
    "title": "07 FW Bellagio",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Bellagio?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 3,
    "name": "07 FW Governors",
    "title": "07 FW Governors",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Governors?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 4,
    "name": "07 FW Heritage Classic",
    "title": "07 FW Heritage Classic",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Heritage_Classic?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 5,
    "name": "07 FW Heritage Fashion",
    "title": "07 FW Heritage Fashion",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Heritage_Fashion?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 6,
    "name": "07 FW Kensington I",
    "title": "07 FW Kensington I",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Kensington_I?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 7,
    "name": "07 FW Kensington II",
    "title": "07 FW Kensington II",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Kensington_II?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 8,
    "name": "07 FW Lords",
    "title": "07 FW Lords",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Lords?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 9,
    "name": "07 FW Trofeo",
    "title": "07 FW Trofeo",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Trofeo?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 10,
    "name": "07 FW Zenith Cashmere",
    "title": "07 FW Zenith Cashmere",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_FW_Zenith_Cashmere?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 11,
    "name": "07 SS Cambridge",
    "title": "07 SS Cambridge",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Cambridge?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 12,
    "name": "07 SS Governors",
    "title": "07 SS Governors",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Governors?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 13,
    "name": "07 SS Heritage Classic",
    "title": "07 SS Heritage Classic",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Heritage_Classic?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 14,
    "name": "07 SS Heritage Fashion",
    "title": "07 SS Heritage Fashion",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Heritage_Fashion?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 15,
    "name": "07 SS Lords",
    "title": "07 SS Lords",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Lords?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 16,
    "name": "07 SS Queensborough",
    "title": "07 SS Queensborough",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Queensborough?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 17,
    "name": "07 SS Thomas",
    "title": "07 SS Thomas",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Thomas?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 18,
    "name": "07 SS Yorkshire",
    "title": "07 SS Yorkshire",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Yorkshire?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 19,
    "name": "07 SS Zenith",
    "title": "07 SS Zenith",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/07_SS_Zenith?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 20,
    "name": "08 SS Barberis",
    "title": "08 SS Barberis",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Barberis?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 21,
    "name": "08 SS Florence Cottons",
    "title": "08 SS Florence Cottons",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Florence_Cottons?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 22,
    "name": "08 SS Florence Gabardines",
    "title": "08 SS Florence Gabardines",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Florence_Gabardines?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 23,
    "name": "08 SS Heritage I",
    "title": "08 SS Heritage I",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Heritage_I?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 24,
    "name": "08 SS Heritage II",
    "title": "08 SS Heritage II",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Heritage_II?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 25,
    "name": "08 SS Jamison Fancies",
    "title": "08 SS Jamison Fancies",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Jamison_Fancies?&hei=100",
    "digital_pdf_url": null
  },
  {
    "id": 26,
    "name": "08 SS Jamison Flannels",
    "title": "08 SS Jamison Flannels",
    "datecode": "",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/08_SS_Jamison_Flannels?&hei=100",
    "digital_pdf_url": null
  }
]

Returns an array of fabric collections.

HTTP Request

GET https://api.trinity-apparel.com/v1/collections

Query Parameters

Parameter Default Description
is_active true If set to true, the result will only include active collections.
reverse_sort false If set to true, collections will be sorted descending by collection_id.
extended false If set to true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Get a Specific Collection

curl "https://api.trinity-apparel.com/v1/collections/1854"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 1854,
    "name": "Outerwear V18082",
    "title": "Outerwear",
    "datecode": "V18082",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/Outerwear_V18082?&hei=100",
    "digital_pdf_url": "https://trinity-apparel.s3.amazonaws.com/assets/digital_collection_outerwear_18082.pdf",
    "description": null,
    "fabrics": [
        {
            "id": 54921,
            "active": true,
            "description": "Blue Navy Plaid",
            "supplier_fabric_number": "BT65151-1",
            "trinity_fabric_number": "C4-3754921",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/C4-3754921",
            "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=C4-3754921&res=300",
            "pattern_id": 4,
            "weave_id": null,
            "price_tier": 1,
            "discount": null,
            "has_image": true,
            "favorite_id": null,
            "fabric_type": null,
            "fabric_garment_type": 231,
            "trim_garment_type": 0
        },
        .
        .
        .,
        {
            "id": 54966,
            "active": true,
            "description": "Black Solid",
            "supplier_fabric_number": "9901-7",
            "trinity_fabric_number": "K3-3754966",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/K3-3754966",
            "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=K3-3754966&res=300",
            "pattern_id": 1,
            "weave_id": null,
            "price_tier": 3,
            "discount": null,
            "has_image": true,
            "favorite_id": null,
            "fabric_type": null,
            "fabric_garment_type": 231,
            "trim_garment_type": 0
        }
    ]
}

Returns details on a fabric collection and a list of all fabrics in that collection.

HTTP Request

GET https://api.trinity-apparel.com/v1/collections/:id

Query Parameters

Parameter Default Description
id N/A The specific collection id you want to see

Favorites

You can send favorites instead of :id (GET https://api.trinity-apparel.com/v1/collections/favorites) and you will instead get a collection of your favorited fabrics.

Other

Get All Fabrics

curl "https://api.trinity-apparel.com/v1/fabrics"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 25600,
        "active": true,
        "description": "Fawn Solid",
        "supplier_fabric_number": "8427",
        "trinity_fabric_number": "U7-3025600",
        "collection_id": 1185,
        "url": "https://s7d4.scene7.com/is/image/trinityapparel/U7-3025600",
        "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=U7-3025600&res=300",
        "pattern_id": 1,
        "weave_id": null,
        "price_tier": 3,
        "discount": null,
        "has_image": false,
        "favorite_id": null,
        "fabric_garment_type": 199,
        "trim_garment_type": 0,
        "material_type": "Fabric",
        "factories": ...
    },
    {
        "id": 26880,
        "active": true,
        "description": "Taupe Paisley",
        "supplier_fabric_number": "CH-1898-27",
        "trinity_fabric_number": "L2-3026880",
        "collection_id": 1185,
        "url": "https://s7d4.scene7.com/is/image/trinityapparel/L2-3026880",
        "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=L2-3026880&res=300",
        "pattern_id": 36,
        "weave_id": null,
        "price_tier": 1,
        "discount": null,
        "has_image": true,
        "favorite_id": null,
        "fabric_garment_type": 247,
        "trim_garment_type": 759,
        "material_type": "Fabric",
        "factories": ...
    },
    .
    .
    .,
    {
        "id": 39936,
        "active": true,
        "description": "Pink Woven Herringbone",
        "supplier_fabric_number": "ST 64486-85",
        "trinity_fabric_number": "S3-3339936",
        "collection_id": 1185,
        "url": "https://s7d4.scene7.com/is/image/trinityapparel/S3-3339936",
        "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=S3-3339936&res=300",
        "pattern_id": null,
        "weave_id": 2,
        "price_tier": 3,
        "discount": null,
        "has_image": true,
        "favorite_id": null,
        "fabric_garment_type": 8,
        "trim_garment_type": 0,
        "material_type": "Fabric",
        "factories": ...
    }
]

Returns an array of fabrics.

Use this API call to lookup a fabric by trinity fabric number or supplier fabric number. We recommend using the fabric_number parameter to do a lookup, then pulling the first result from the array.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabrics

Query Parameters

Parameter Default Description
collection_id N/A Only return fabrics from a specific collection.
has_image false If set to true, will only return fabrics that have a working image url.
q N/A Wildcard matching search by trinity fabric number, supplier fabric number, fabric price code, and fabric description.
fabric_number N/A Show fabrics that match supplier fabric number or a trinity fabric number. The trinity fabric number is an exact match, whereas the supplier number is a wildcard match.
trinity_fabric_number N/A Show fabrics that match a specific Trinity fabric number. See below for example querying for multiple fabrics.
supplier_fabric_number N/A Show fabrics that match a specific Supplier fabric number. See below for example querying for multiple fabrics.
fabric_price_code_id N/A Show fabrics that match a specific fabric price code.
pattern_id N/A Show fabrics that match a specific pattern, plus all child patterns of that id
weave_id N/A Show fabrics that match a specific weave, plus all child patterns of that id
price_tier N/A Show fabrics that match a specific price tier (Must be between 1-4).
garment_type N/A An integer between 1 and 1023. garment_type is a bitmask which allows us to turn on and off different garment types, such as pant and shirt easily
trim_garment_type N/A An integer between 1 and 1023. garment_type is a bitmask which allows us to turn on and off different trim garment types, such as shirt trim or jacket lining easily
show_archived false By default archived fabrics (not active, not in stock or temp out) are not returned. Set this to true in order to show all fabrics.
reverse_sort N/A If this parameter is set, fabrics will be sorted descending by fabric_id.
extended false If set to true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Querying by multiple fabric numbers

In order to query for multiple fabric numbers, you will pass in multiple params with the array-style format like below:

GET https://api.trinity-apparel.com/v1//fabrics?trinity_fabric_number[]=C4-3754922&trinity_fabric_number[]=C4-3754923&trinity_fabric_number[]=C4-3754924

OR

GET https://api.trinity-apparel.com/v1//fabrics?supplier_fabric_number[]=602%20275%20800&supplier_fabric_number[]=602%20275%20802&supplier_fabric_number[]=602%20275%20802

Get a Specific Fabric

curl "https://api.trinity-apparel.com/v1/fabrics/40985"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 40985,
  "active": true,
  "description": "Lavender Dobby",
  "supplier_fabric_number": "P39315/02",
  "trinity_fabric_number": "S2-3540985",
  "collection_id": 1520,
  "url": "https://s7d4.scene7.com/is/image/trinityapparel/S2-3540985",
  "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=S2-3540985&res=300",
  "pattern_id": null,
  "weave_id": 3,
  "price_tier": 3,
  "discount": null,
  "has_image": true,
  "favorite_id": null,
  "fabric_garment_type": 8,
  "trim_garment_type": 0,
  "material_type": "Fabric",
  "factories": {
    "iD": {
      "in_stock": false,
      "restock_date": null,
      "last_edit_date": "2020-12-15T14:08:08.000Z",
      "availability": "at once"
    }
  },
  "country_origin": "International",
  "fabric_grouping": "shirts",
  "pattern": "solid",
  "usage": "Garments",
  "last_stock_edit_date": "2020-12-15T14:08:08.000Z",
  "fabric_year": 2017,
  "fabric_garment_types": ["CSHT"],
  "trim_garment_types": [],
  "weight": 125,
  "lead_time": "Stocked",
  "alternate_images": [
    {
      "name": "Shirt",
      "code": "CSHT",
      "description": "Shirt Laydown",
      "url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/CSHT-AS-FC4AMF-4x4?&obj=CSHT/Fabric&src=S2-3540985&res=300&obj=CSHT/Buttons&color=235,230,214&obj=CSHT/Thread&color=244,241,244&obj=CSHT/Fabric/Neckband_In&src=S2-3540985&res=300&obj=CSHT/Fabric/Collar&src=S2-3540985&res=300&obj=CSHT/Fabric/Yoke_In&src=S2-3540985&res=300&obj=CSHT/Fabric/Cuff_Out&src=S2-3540985&res=300&obj=CSHT/Fabric/Fronts/Placket&src=S2-3540985&res=300"
    }
  ],
  "related_trim": null,
  "collection": {
    "id": 1520,
    "name": "Soktas Bespoke V17082",
    "title": "Soktas Bespoke",
    "datecode": "V17082",
    "image": "https://s7d4.scene7.com/is/image/trinityapparel/Soktas_Bespoke_V17082?&hei=100",
    "digital_pdf_url": null
  },
  "fabric_pattern": null,
  "fabric_weave": {
    "id": 3,
    "name": "dobby",
    "position": 3
  },
  "price_code": {
    "code": "S2",
    "description": "Soktas Bespoke",
    "tier": 3
  },
  "supplier": {
    "id": 57,
    "code": "SK",
    "name": "Soktas",
    "city": "Söke",
    "state": "Aydin",
    "country": "Turkey"
  },
  "composition": {
    "id": 13,
    "description": "100% Cotton"
  }
}

Returns details on a specific fabric.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabrics/:id

Query Parameters

Parameter Default Description
id N/A The specific fabric id you want to see

Other

Advanced Fabric Queries

curl "https://api.trinity-apparel.com/v1/fabrics?collection_id=1812"
  -H "Authorization Bearer: swaledale"

The above command returns Temp Out fabrics from collection 1812

curl "https://api.trinity-apparel.com/v1/fabrics?price_tier=4"
  -H "Authorization Bearer: swaledale"

The above command returns all expensive in stock fabrics

curl "https://api.trinity-apparel.com/v1/fabrics?garment_type=5"
  -H "Authorization Bearer: swaledale"

The above command returns Suiting, i.e. Coat (1) + Pant (4) = 5, usage Garment (1)

curl "https://api.trinity-apparel.com/v1/fabrics?trim_garment_type=1"
  -H "Authorization Bearer: swaledale"

The above command returns Lining, i.e. Jackets (1), usage Clothing Trim (4)

curl "https://api.trinity-apparel.com/v1/fabrics?garment_type=8"
  -H "Authorization Bearer: swaledale"

The above command returns Shirting, i.e. Shirts (8), usage Garment (1)

curl "https://api.trinity-apparel.com/v1/fabrics?trim_garment_type=8"
  -H "Authorization Bearer: swaledale"

The above command returns Shirt trims, i.e. Shirts (8), usage Shirt Trims (2)

curl "https://api.trinity-apparel.com/v1/fabrics?garment_type=32"
  -H "Authorization Bearer: swaledale"

The above command returns Outerwear, i.e. Outerwear (32), usage Garment (1)

curl "https://api.trinity-apparel.com/v1/fabrics?pattern_id=5"
  -H "Authorization Bearer: swaledale"

The above command returns fabrics of the "print" pattern

curl "https://api.trinity-apparel.com/v1/fabrics?weave_id=2"
  -H "Authorization Bearer: swaledale"

The above command returns fabrics of the "herrinbone" weave

Search by garment type, usage, stock availability, and price tier.

Query Parameters

Parameter Description
garment_type A bitmask to search for fabrics that are used by particular garment types
trim_garment_type A bitmask to search for fabrics that are used as trim in particular garment types
price_tier 1-4, 4 being most expensive
pattern_id Filter by pattern, see table below
weave_id Filter by weave, see table below

Garment Bitmask

Works the same for trims.

Garment Type Bitmask
GARMENT_COAT 1
GARMENT_VEST 2
GARMENT_PANT 4
GARMENT_SHIRT 8
GARMENT_PANT2 16
GARMENT_TOPCOAT 32
GARMENT_SHORT 64
GARMENT_BREEK 128
GARMENT_TIE 256
GARMENT_SWK 512
GARMENT_ALLSUIT GARMENT_COAT OR GARMENT_VEST OR GARMENT_PANT OR GARMENT_SHORT OR GARMENT_BREEK OR GARMENT_SWK
GARMENT_ALL GARMENT_COAT OR GARMENT_VEST OR GARMENT_PANT OR GARMENT_TOPCOAT OR GARMENT_SHORT OR GARMENT_BREEK OR GARMENT_SHIRT OR GARMENT_SWK
GARMENT_ALLPANT GARMENT_PANT OR GARMENT_SHORT OR GARMENT_BREEK
GARMENT_ALLCOAT GARMENT_COAT OR GARMENT_TOPCOAT
GARMENT_ALLCLOTHING GARMENT_ALLSUIT OR GARMENT_TOPCOAT OR GARMENT_PANT2

(OR here is Bitwise OR)

Patterns to Use

Pattern ID
solid 1
stripe 2
check 3
plaid 4
print 5
windowpane 6
other 7

Weaves to Use

Weave ID
plain 1
herringbone 2
dobby 3
poplin 4
broadcloth 5
chambray 6
twill 7
basket 8
other 9
curl "https://api.trinity-apparel.com/v1/fabrics/39001/related"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 61814,
    "active": true,
    "description": "Lt Blue Houndstooth Check Twill",
    "supplier_fabric_number": "FM19000-13",
    "trinity_fabric_number": "Z8-3961814",
    "collection_id": 1951,
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/Z8-3961814",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=Z8-3961814&res=300",
    "pattern_id": 41,
    "weave_id": 7,
    "price_tier": 4,
    "discount": null,
    "has_image": true,
    "favorite_id": null,
    "fabric_garment_type": 8,
    "trim_garment_type": 0,
    "material_type": "Fabric",
    "factories": {
      "iD": {
        "in_stock": true,
        "restock_date": null,
        "last_edit_date": null,
        "availability": "single-cut"
      }
    }
  },
  {
    "id": 61815,
    "active": true,
    "description": "Lavendar Houndstooth Check Twill",
    "supplier_fabric_number": "FM19000-81",
    "trinity_fabric_number": "Z8-3961815",
    "collection_id": 1951,
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/Z8-3961815",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=Z8-3961815&res=300",
    "pattern_id": 41,
    "weave_id": 7,
    "price_tier": 4,
    "discount": null,
    "has_image": true,
    "favorite_id": null,
    "fabric_garment_type": 8,
    "trim_garment_type": 0,
    "material_type": "Fabric",
    "factories": {
      "iD": {
        "in_stock": true,
        "restock_date": null,
        "last_edit_date": null,
        "availability": "single-cut"
      }
    }
  },
  {
    "id": 61816,
    "active": true,
    "description": "Blue Houndstooth Check Twill",
    "supplier_fabric_number": "FM19000-11",
    "trinity_fabric_number": "Z8-3961816",
    "collection_id": 1951,
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/Z8-3961816",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=Z8-3961816&res=300",
    "pattern_id": 41,
    "weave_id": 7,
    "price_tier": 4,
    "discount": null,
    "has_image": true,
    "favorite_id": null,
    "fabric_garment_type": 8,
    "trim_garment_type": 0,
    "material_type": "Fabric",
    "factories": {
      "iD": {
        "in_stock": true,
        "restock_date": null,
        "last_edit_date": null,
        "availability": "single-cut"
      }
    }
  }
]

Returns a list of up to 10 related fabrics.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabrics/:id/related

Query Parameters

Parameter Default Description
id N/A The specific fabric id you want to see related fabrics for.
rpp 10 The number of results you would like to return.
extended false If set to true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Sorting Algorithm

Materials API

Material Resources

The current materials are Buttons, Felts, Labels, Piping, Suedes, Threads, Trouser Trim, and Zippers. Each material has its own endpoint, but they all work in a nearly identical way and provide the same routes and parameters. There are a few exceptions as shown below.

Buttons, Felts, Suedes

# Standard Object - Used in a resource collection
{
  "value": "KYKW023_Tan",
  "description": "2-10 Tan Marbled Premium",
  "code": "2-10",
  "title": "Tan Marbled",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-10_Tan_Marbled_Premium?hei=200",
  "rgb": "107,96,72",
  "display_order": 31,
  "active": true
}

Standard Attributes

Attribute Description
value
string
Unique identifier for the material.
description
string
Human readable description of the material.
code
string
Used internally to determine which button can be used on which garments.
title
string
The description with the code removed.
image
string
The url for an image of the material.
rgb
string
The RGB code for the primary color of the material.
display_order
integer
The order that the material is displayed in Workflow.
active
boolean
Inactive materials are removed from search results by default.

Labels

# Standard Object - Used in a resource collection
{
  "value": "ivory_label",
  "description": "Ivory Label",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/ivory_label?wid=300",
  "rgb": null,
  "display_order": 0,
  "active": true
}

Standard Attributes

Attribute Description
value
string
Unique identifier for the label.
description
string
Human readable description of the label.
image
string
The url for an image of the label.
rgb
string
The RGB code for the primary color of the label.
display_order
integer
The order that the label is displayed in Workflow.
active
boolean
Inactive labels are removed from search results by default.

Pipings

# Standard Object - Used in a resource collection
{
  "id": 44328,
  "trinity_fabric_number": "TR-3644328",
  "lining_fabric_number": "L1-3026873",
  "description": "Cherry Solid",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644328?hei=200",
  "active": true
}

Standard Attributes

Attribute Description
id
number
Unique identifier for the piping.
trinity_fabric_number
string
The fabric number for the piping.
lining_fabric_number
string
The lining fabric number for the piping.
description
string
Human readable description of the piping.
image
string
The url for an image of the piping.
active
boolean
Inactive pipings are removed from search results by default.

Threads

# Standard Object - Used in a resource collection
{
  "value": "black",
  "code": "C9770",
  "description": "Black",
  "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Colcolor=36,36,36&fmt=png-alpha",
  "rgb": "36,36,36",
  "display_order": 4,
  "active": 1
}

Standard Attributes

Attribute Description
value
string
Unique identifier for the thread.
code
string
A five digit code used for Milanese Lapels.
description
string
Human readable description of the thread.
image
string
The url for an image of the thread.
rgb
string
The RGB code for the primary color of the thread.
display_order
integer
The order that the thread is displayed in Workflow.
active
boolean
Inactive threads are removed from search results by default.

Trouser Trims, Zippers

# Standard Object - Used in a resource collection
{
  "id": 1,
  "value": "white_blue_micro_floral",
  "description": "White Blue Micro Floral",
  "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_triwhite_blue_micro_floral.jpg",
  "display_order": 5,
  "active": true,
  "created_at": "2022-02-21T12:12:10.000Z",
  "updated_at": "2022-02-21T12:12:10.000Z"
}

Standard Attributes

Attribute Description
id
number
Numeric unique identifier for the material.
value
string
Named unique identifier for the material.
description
string
Human readable description of the material.
image
string
The url for an image of the material.
display_order
integer
The order that the material is displayed in Workflow.
active
boolean
Inactive materials are removed from search results by default.
created_at
date
Date that the material was created.
updated_at
date
Date that the material was last updated.

Get All Buttons

curl "https://api.trinity-apparel.com/v1/buttons"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "value": "KYKW023_Tan",
    "description": "2-10 Tan Marbled Premium",
    "code": "2-10",
    "title": "Tan Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-10_Tan_Marbled_Premium?hei=200",
    "rgb": "107,96,72",
    "display_order": 31,
    "active": true
  },
  {
    "value": "KYKW024_Cinnamon",
    "description": "2-11 Cinnamon Marbled Premium",
    "code": "2-11",
    "title": "Cinnamon Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-11_Cinnamon_Marbled_Premium?hei=200",
    "rgb": "115,76,62",
    "display_order": 32,
    "active": true
  },
  {
    "value": "KYKW025_Taupe",
    "description": "2-12 Taupe Marbled Premium",
    "code": "2-12",
    "title": "Taupe Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-12_Taupe_Marbled_Premium?hei=200",
    "rgb": "99,93,69",
    "display_order": 33,
    "active": true
  },
  {
    "value": "KYKW026_Grey",
    "description": "2-02 Grey Marbled Premium",
    "code": "2-02",
    "title": "Grey Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-02_Grey_Marbled_Premium?hei=200",
    "rgb": "79,79,76",
    "display_order": 34,
    "active": true
  },
  {
    "value": "KYKW027_Dark_Brown",
    "description": "2-13 Dark Brown Marbled Premium",
    "code": "2-13",
    "title": "Dark Brown Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-13_Dark_Brown_Marbled_Premium?hei=200",
    "rgb": "46,36,23",
    "display_order": 35,
    "active": true
  },
  {
    "value": "KYKW028_Charcoal",
    "description": "2-03 Charcoal Marbled Premium",
    "code": "2-03",
    "title": "Charcoal Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-03_Charcoal_Marbled_Premium?hei=200",
    "rgb": "50,50,50",
    "display_order": 36,
    "active": true
  },
  {
    "value": "KYKW022_Black",
    "description": "2-04 Black Marbled Premium",
    "code": "2-04",
    "title": "Black Marbled",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-04_Black_Marbled_Premium?hei=200",
    "rgb": "43,43,43",
    "display_order": 30,
    "active": true
  },
  {
    "value": "KW017_Shield",
    "description": "2-23 Shield Premium",
    "code": "2-23",
    "title": "Shield",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-23_Shield_Premium?hei=200",
    "rgb": "43,43,43",
    "display_order": 28,
    "active": true
  },
  {
    "value": "KW018_Skull",
    "description": "2-24 Skull Premium",
    "code": "2-24",
    "title": "Skull",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-24_Skull_Premium?hei=200",
    "rgb": "157,157,157",
    "display_order": 29,
    "active": true
  },
  {
    "value": "KB002_White_MOP",
    "description": "1-31 White Mother of Pearl",
    "code": "1-31",
    "title": "White Mother of Pearl",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-31_White_Mother_of_Pearl?hei=200",
    "rgb": "233,235,226",
    "display_order": 17,
    "active": true
  },
  {
    "value": "KB001_Smoke_MOP",
    "description": "1-32 Smoke Mother of Pearl",
    "code": "1-32",
    "title": "Smoke Mother of Pearl",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-32_Smoke_Mother_of_Pearl?hei=200",
    "rgb": "46,58,73",
    "display_order": 18,
    "active": true
  },
  {
    "value": "KG034_Dark_Olive",
    "description": "1-26 Dark Olive",
    "code": "1-26",
    "title": "Dark Olive",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-26_Dark_Olive?hei=200",
    "rgb": "49,49,27",
    "display_order": 19,
    "active": true
  },
  {
    "value": "KG036_Navy",
    "description": "1-08 Navy",
    "code": "1-08",
    "title": "Navy",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-08_Navy?hei=200",
    "rgb": "37,37,49",
    "display_order": 5,
    "active": true
  },
  {
    "value": "KG038_Dark_Taupe",
    "description": "1-25 Dark Taupe",
    "code": "1-25",
    "title": "Dark Taupe",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-25_Dark_Taupe?hei=200",
    "rgb": "69,45,42",
    "display_order": 6,
    "active": true
  },
  {
    "value": "KG051_Ivory",
    "description": "1-18 Ivory",
    "code": "1-18",
    "title": "Ivory",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-18_Ivory?hei=200",
    "rgb": "254,235,179",
    "display_order": 8,
    "active": true
  },
  {
    "value": "KG052_Coffee",
    "description": "1-22 Coffee",
    "code": "1-22",
    "title": "Coffee",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-22_Coffee?hei=200",
    "rgb": "107,81,45",
    "display_order": 9,
    "active": true
  },
  {
    "value": "KG039_Charcoal_Grey",
    "description": "1-05 Charcoal Gray",
    "code": "1-05",
    "title": "Charcoal Gray",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-05_Charcoal_Gray?hei=200",
    "rgb": "77,75,75",
    "display_order": 4,
    "active": true
  },
  {
    "value": "KG041_Sand",
    "description": "1-19 Sand",
    "code": "1-19",
    "title": "Sand",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-19_Sand?hei=200",
    "rgb": "185,160,120",
    "display_order": 7,
    "active": true
  },
  {
    "value": "KG056_Caramel",
    "description": "1-20 Caramel",
    "code": "1-20",
    "title": "Caramel",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-20_Caramel?hei=200",
    "rgb": "133,109,72",
    "display_order": 10,
    "active": true
  },
  {
    "value": "KG062_Tan",
    "description": "1-21 Tan",
    "code": "1-21",
    "title": "Tan",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-21_Tan?hei=200",
    "rgb": "130,86,31",
    "display_order": 11,
    "active": true
  },
  {
    "value": "KG064_Medium_Brown",
    "description": "1-23 Medium Brown",
    "code": "1-23",
    "title": "Medium Brown",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-23_Medium_Brown?hei=200",
    "rgb": "85,60,36",
    "display_order": 12,
    "active": true
  },
  {
    "value": "KG069_Dark_Brown",
    "description": "1-24 Dark Brown",
    "code": "1-24",
    "title": "Dark Brown",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-24_Dark_Brown?hei=200",
    "rgb": "50,34,18",
    "display_order": 13,
    "active": true
  },
  {
    "value": "KG019_Black",
    "description": "1-06 Black",
    "code": "1-06",
    "title": "Black",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-06_Black?hei=200",
    "rgb": "43,43,43",
    "display_order": 3,
    "active": true
  },
  {
    "value": "KNJ011_Dark_Brown",
    "description": "1-30 Dark Brown Horn",
    "code": "1-30",
    "title": "Dark Brown Horn",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-30_Dark_Brown_Horn?hei=200",
    "rgb": "33,35,32",
    "display_order": 14,
    "active": true
  },
  {
    "value": "KNJ012_Medium_Brown",
    "description": "1-28 Medium Brown Horn",
    "code": "1-28",
    "title": "Medium Brown Horn",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-28_Medium_Brown_Horn?hei=200",
    "rgb": "72,52,31",
    "display_order": 15,
    "active": true
  }
]

Returns an array of active buttons.

HTTP Request

GET https://api.trinity-apparel.com/v1/buttons

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive buttons.
description N/A If set, will return any buttons with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid buttons for that option value.
garment_type N/A If set, returns all valid buttons for those garment_type bitmask

Other

Querying by multiple button descriptions

In order to query for multiple buttons, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/buttons?description[]=2-10 Tan Marbled Premium&description[]=2-12 Taupe Marbled Premium&description[]=2-04 Black Marbled Premium

Get a Specific Button

curl "https://api.trinity-apparel.com/v1/buttons/KYKW022_Black"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "value": "KYKW022_Black",
  "description": "2-04 Black Marbled Premium",
  "code": "2-04",
  "title": "Black Marbled",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-04_Black_Marbled_Premium?hei=200",
  "rgb": "43,43,43",
  "display_order": 30,
  "active": true
}

Returns details on a specific button.

HTTP Request

GET https://api.trinity-apparel.com/v1/buttons/:value

Query Parameters

Parameter Default Description
value N/A The specific button value you want to see

Other

Get All Felts

curl "https://api.trinity-apparel.com/v1/felts"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "value": "KYFLD-90642-1_ivory",
    "description": "6-01 Ivory",
    "code": "6-01",
    "title": "Ivory",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-01_Ivory?&hei=200",
    "rgb": "239,232,225",
    "display_order": 1,
    "active": true
  },
  {
    "value": "KYFLD-90642-11_red",
    "description": "6-19 Red",
    "code": "6-19",
    "title": "Red",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-19_Red?&hei=200",
    "rgb": "159,17,31",
    "display_order": 19,
    "active": true
  },
  {
    "value": "KYFLD-90642-13_emerald_green",
    "description": "6-44 Emerald Green",
    "code": "6-44",
    "title": "Emerald Green",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-44_Emerald?&hei=200",
    "rgb": "79,73,41",
    "display_order": 44,
    "active": true
  },
  {
    "value": "KYFLD-90985-6_purple",
    "description": "6-15 Purple",
    "code": "6-15",
    "title": "Purple",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-15_Purple?&hei=200",
    "rgb": "60,40,53",
    "display_order": 15,
    "active": true
  },
  {
    "value": "FLD-0614_navy",
    "description": "6-07 Navy",
    "code": "6-07",
    "title": "Navy",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-07_Navy?&hei=200",
    "rgb": "39,39,49",
    "display_order": 7,
    "active": true
  },
  {
    "value": "KYFLD-90985-8_maroon",
    "description": "6-17 Maroon",
    "code": "6-17",
    "title": "Maroon",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-17_Maroon?&hei=200",
    "rgb": "80,28,31",
    "display_order": 17,
    "active": true
  },
  {
    "value": "KYFLD-90985-11_royal_blue",
    "description": "6-09 Royal Blue",
    "code": "6-09",
    "title": "Royal Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-09_Royal_Blue?&hei=200",
    "rgb": "39,92,174",
    "display_order": 9,
    "active": true
  },
  {
    "value": "KYFLD-90985-16_forest_green",
    "description": "6-46 Forest Green",
    "code": "6-46",
    "title": "Forest Green",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-46_Forest_Green?&hei=200",
    "rgb": "62,79,59",
    "display_order": 46,
    "active": true
  },
  {
    "value": "FLD-0634_black",
    "description": "6-05 Black",
    "code": "6-05",
    "title": "Black",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-05_Black?&hei=200",
    "rgb": "30,30,30",
    "display_order": 5,
    "active": true
  },
  {
    "value": "FLD-0626_charcoal",
    "description": "6-04 Charcoal",
    "code": "6-04",
    "title": "Charcoal",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-04_Charcoal?&hei=200",
    "rgb": "56,52,52",
    "display_order": 4,
    "active": true
  },
  {
    "value": "FLD-0640_midnight_blue",
    "description": "6-06 Midnight Blue",
    "code": "6-06",
    "title": "Midnight Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-06_Midnight_Blue?&hei=200",
    "rgb": "36,43,64",
    "display_order": 6,
    "active": true
  },
  {
    "value": "FLD-0625_moss_green",
    "description": "6-43 Moss Green",
    "code": "6-43",
    "title": "Moss Green",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-43_Moss?&hei=200",
    "rgb": "97,83,72",
    "display_order": 43,
    "active": true
  },
  {
    "value": "FLD-0695_vicuna",
    "description": "6-26 Vicuna",
    "code": "6-26",
    "title": "Vicuna",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-26_Vicuna?&hei=200",
    "rgb": "188,127,76",
    "display_order": 26,
    "active": true
  },
  {
    "value": "FLD-0620_dark_brown",
    "description": "6-28 Dark Brown",
    "code": "6-28",
    "title": "Dark Brown",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-28_Dark_Brown?&hei=200",
    "rgb": "81,56,45",
    "display_order": 28,
    "active": true
  },
  {
    "value": "FLD-0630_light_gray",
    "description": "6-03 Light Gray",
    "code": "6-03",
    "title": "Light Gray",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-03_Light_Gray?&hei=200",
    "rgb": "141,136,133",
    "display_order": 3,
    "active": true
  },
  {
    "value": "FLD-F900-38_teal_blue",
    "description": "6-39 Teal Blue",
    "code": "6-39",
    "title": "Teal Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-39_Teal_Blue?&hei=200",
    "rgb": "87,160,149",
    "display_order": 39,
    "active": true
  },
  {
    "value": "FLD-F900-46_lavender",
    "description": "6-14 Lavender",
    "code": "6-14",
    "title": "Lavender",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-14_Lavender?&hei=200",
    "rgb": "148,106,143",
    "display_order": 14,
    "active": true
  },
  {
    "value": "FLD-F900-F8_pink",
    "description": "6-21 Pink",
    "code": "6-21",
    "title": "Pink",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-21_Pink?&hei=200",
    "rgb": "254,148,163",
    "display_order": 21,
    "active": true
  },
  {
    "value": "FLD-F900-27_olive",
    "description": "6-45 Olive",
    "code": "6-45",
    "title": "Olive",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-45_Olive?&hei=200",
    "rgb": "67,68,49",
    "display_order": 45,
    "active": true
  },
  {
    "value": "FLD-F900-26_ecru",
    "description": "6-23 Ecru",
    "code": "6-23",
    "title": "Ecru",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-23_Ecru?&hei=200",
    "rgb": "216,202,185",
    "display_order": 23,
    "active": true
  },
  {
    "value": "FLD-F900-17_celery",
    "description": "6-41 Celery",
    "code": "6-41",
    "title": "Celery",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-41_Celery?&hei=200",
    "rgb": "155,139,110",
    "display_order": 41,
    "active": true
  },
  {
    "value": "FLD-F900-20_sage",
    "description": "6-42 Sage",
    "code": "6-42",
    "title": "Sage",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-42_Sage?&hei=200",
    "rgb": "132,108,77",
    "display_order": 42,
    "active": true
  },
  {
    "value": "NB101_camel",
    "description": "6-25 Camel",
    "code": "6-25",
    "title": "Camel",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-25_Camel?&hei=200",
    "rgb": "163,124,87",
    "display_order": 25,
    "active": true
  },
  {
    "value": "NB112_cranberry",
    "description": "6-18 Cranberry",
    "code": "6-18",
    "title": "Cranberry",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-18_Cranberry?&hei=200",
    "rgb": "97,30,36",
    "display_order": 18,
    "active": true
  },
  {
    "value": "NB010_french_blue",
    "description": "6-08 French Blue",
    "code": "6-08",
    "title": "French Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-08_French_Blue?&hei=200",
    "rgb": "23,83,130",
    "display_order": 8,
    "active": true
  }
]

Returns an array of active felts.

HTTP Request

GET https://api.trinity-apparel.com/v1/felts

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive felts.
description N/A If set, will return any felts with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid felts for that option value.

Other

Querying by multiple felt descriptions

In order to query for multiple felts, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/felts?description[]=6-01 Ivory&description[]=6-07 Navy&description[]=6-17 Maroon

Get a Specific Felt

curl "https://api.trinity-apparel.com/v1/felts/KYFLD-90985-6_purple"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "value": "KYFLD-90985-6_purple",
  "description": "6-15 Purple",
  "code": "6-15",
  "title": "Purple",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-15_Purple?&hei=200",
  "rgb": "60,40,53",
  "display_order": 15,
  "active": true
}

Returns details on a specific felt.

HTTP Request

GET https://api.trinity-apparel.com/v1/felts/:value

Query Parameters

Parameter Default Description
value N/A The specific felt value you want to see

Other

Get All Labels

curl "https://api.trinity-apparel.com/v1/labels"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "value": "ivory_label",
    "description": "Ivory Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/ivory_label?wid=300",
    "rgb": null,
    "display_order": 0,
    "active": 1
  },
  {
    "value": "purple_label",
    "description": "Purple Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/purple_label?wid=300",
    "rgb": null,
    "display_order": 1,
    "active": 1
  },
  {
    "value": "green_label",
    "description": "Green Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/green_label?wid=300",
    "rgb": null,
    "display_order": 2,
    "active": 1
  },
  {
    "value": "tan_label",
    "description": "Tan Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/tan_label?wid=300",
    "rgb": null,
    "display_order": 3,
    "active": 1
  },
  {
    "value": "maroon_label",
    "description": "Maroon Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/maroon_label?wid=300",
    "rgb": null,
    "display_order": 4,
    "active": 1
  },
  {
    "value": "blue_label",
    "description": "Blue Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/blue_label?wid=300",
    "rgb": null,
    "display_order": 5,
    "active": 1
  },
  {
    "value": "sky_blue_label",
    "description": "Sky Blue Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/sky_blue_label?wid=300",
    "rgb": null,
    "display_order": 6,
    "active": 1
  },
  {
    "value": "orange_label",
    "description": "Orange Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/orange_label?wid=300",
    "rgb": null,
    "display_order": 7,
    "active": 1
  },
  {
    "value": "red_label",
    "description": "Red Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/red_label?wid=300",
    "rgb": null,
    "display_order": 8,
    "active": 1
  },
  {
    "value": "label",
    "description": "Black Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/black_label?wid=300",
    "rgb": null,
    "display_order": 9,
    "active": 1
  },
  {
    "value": "direct_embroider_lining",
    "description": "Embroider Directly on Garment Lining",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/Embroidery_Lining?wid=300",
    "rgb": null,
    "display_order": 10,
    "active": 1
  },
  {
    "value": "direct_embroider_undercollar",
    "description": "Embroidery Directly on Undercollar Felt/Microsuede",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/Embroidery_Undercollar?wid=300",
    "rgb": null,
    "display_order": 11,
    "active": 1
  },
  {
    "value": "no",
    "description": "No",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/no_label?wid=300",
    "rgb": null,
    "display_order": 12,
    "active": 1
  },
  {
    "value": "yellow_label",
    "description": "Yellow Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/yellow_label?wid=300",
    "rgb": null,
    "display_order": 13,
    "active": 1
  },
  {
    "value": "light_gray_label",
    "description": "Light Gray Label",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/light_grey_label?wid=300",
    "rgb": null,
    "display_order": 14,
    "active": 1
  }
]

Returns an array of active labels.

HTTP Request

GET https://api.trinity-apparel.com/v1/labels

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive labels.
description N/A If set, will return any labels with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid labels for that option value.

Other

Querying by multiple label descriptions

In order to query for multiple labels, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/labels?description[]=Ivory Label&description[]=Maroon Label&description[]=Sky Blue Label

Get a Specific Label

curl "https://api.trinity-apparel.com/v1/labels/orange_label"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "value": "orange_label",
  "description": "Orange Label",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/orange_label?wid=300",
  "rgb": null,
  "display_order": 7,
  "active": 1
}

Returns details on a specific label.

HTTP Request

GET https://api.trinity-apparel.com/v1/labels/:value

Query Parameters

Parameter Default Description
value N/A The specific label value you want to see

Other

Get All Pipings

curl "https://api.trinity-apparel.com/v1/material_pipings"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 44299,
    "trinity_fabric_number": "TR-3644299",
    "lining_fabric_number": "L1-3026876",
    "description": "Silver Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644299?hei=200",
    "active": true
  },
  {
    "id": 44300,
    "trinity_fabric_number": "TR-3644300",
    "lining_fabric_number": "L1-3540390",
    "description": "Silver Blue Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644300?hei=200",
    "active": true
  },
  {
    "id": 44301,
    "trinity_fabric_number": "TR-3644301",
    "lining_fabric_number": "LL-2617299",
    "description": "Gray Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644301?hei=200",
    "active": true
  },
  {
    "id": 44303,
    "trinity_fabric_number": "TR-3644303",
    "lining_fabric_number": "LL-2617297",
    "description": "Black Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644303?hei=200",
    "active": true
  },
  {
    "id": 44305,
    "trinity_fabric_number": "TR-3644305",
    "lining_fabric_number": "LL-2617303",
    "description": "Periwinkle Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644305?hei=200",
    "active": true
  },
  {
    "id": 44306,
    "trinity_fabric_number": "TR-3644306",
    "lining_fabric_number": "L1-3026869",
    "description": "Royal Blue Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644306?hei=200",
    "active": true
  },
  {
    "id": 44308,
    "trinity_fabric_number": "TR-3644308",
    "lining_fabric_number": "LL-2617301",
    "description": "Dark Navy Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644308?hei=200",
    "active": true
  },
  {
    "id": 44310,
    "trinity_fabric_number": "TR-3644310",
    "lining_fabric_number": "LL-2617309",
    "description": "Camel Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644310?hei=200",
    "active": true
  },
  {
    "id": 44311,
    "trinity_fabric_number": "TR-3644311",
    "lining_fabric_number": "LL-2617310",
    "description": "Taupe Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644311?hei=200",
    "active": true
  },
  {
    "id": 44312,
    "trinity_fabric_number": "TR-3644312",
    "lining_fabric_number": "LL-2617311",
    "description": "Dark Taupe Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644312?hei=200",
    "active": true
  },
  {
    "id": 44313,
    "trinity_fabric_number": "TR-3644313",
    "lining_fabric_number": "LL-2617308",
    "description": "Toffee Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644313?hei=200",
    "active": true
  },
  {
    "id": 44314,
    "trinity_fabric_number": "TR-3644314",
    "lining_fabric_number": "L1-3026865",
    "description": "Brown Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644314?hei=200",
    "active": true
  },
  {
    "id": 44315,
    "trinity_fabric_number": "TR-3644315",
    "lining_fabric_number": "L1-3026877",
    "description": "White Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644315?hei=200",
    "active": true
  },
  {
    "id": 44317,
    "trinity_fabric_number": "TR-3644317",
    "lining_fabric_number": "L1-3540407",
    "description": "Celery Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644317?hei=200",
    "active": true
  },
  {
    "id": 44318,
    "trinity_fabric_number": "TR-3644318",
    "lining_fabric_number": "L1-3540408",
    "description": "Olive Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644318?hei=200",
    "active": true
  },
  {
    "id": 44319,
    "trinity_fabric_number": "TR-3644319",
    "lining_fabric_number": "L1-3026862",
    "description": "Evergreen Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644319?hei=200",
    "active": true
  },
  {
    "id": 44320,
    "trinity_fabric_number": "TR-3644320",
    "lining_fabric_number": "L1-3026868",
    "description": "Canary Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644320?hei=200",
    "active": true
  },
  {
    "id": 44321,
    "trinity_fabric_number": "TR-3644321",
    "lining_fabric_number": "L1-3026867",
    "description": "Mustard Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644321?hei=200",
    "active": true
  },
  {
    "id": 44322,
    "trinity_fabric_number": "TR-3644322",
    "lining_fabric_number": "L1-3026866",
    "description": "Copper Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644322?hei=200",
    "active": true
  },
  {
    "id": 44323,
    "trinity_fabric_number": "TR-3644323",
    "lining_fabric_number": "L1-3026872",
    "description": "Lavender Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644323?hei=200",
    "active": true
  },
  {
    "id": 44324,
    "trinity_fabric_number": "TR-3644324",
    "lining_fabric_number": "L1-3026871",
    "description": "Magenta Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644324?hei=200",
    "active": true
  },
  {
    "id": 44325,
    "trinity_fabric_number": "TR-3644325",
    "lining_fabric_number": "L1-3540415",
    "description": "Purple Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644325?hei=200",
    "active": true
  },
  {
    "id": 44326,
    "trinity_fabric_number": "TR-3644326",
    "lining_fabric_number": "L1-3026875",
    "description": "Light Pink Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644326?hei=200",
    "active": true
  },
  {
    "id": 44327,
    "trinity_fabric_number": "TR-3644327",
    "lining_fabric_number": "L1-3026874",
    "description": "Berry Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644327?hei=200",
    "active": true
  },
  {
    "id": 44328,
    "trinity_fabric_number": "TR-3644328",
    "lining_fabric_number": "L1-3026873",
    "description": "Cherry Solid",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644328?hei=200",
    "active": true
  }
]

Returns an array of active pipings.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_pipings

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive labels.
description N/A If set, will return any labels with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.

Other

Querying by multiple piping descriptions

In order to query for multiple pipings, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/material_pipings?description[]=Silver Solid&description[]=Silver Blue Solid&description[]=Gray Solid

Get a Specific Piping

curl "https://api.trinity-apparel.com/v1/materials_piping/44303"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 44303,
  "trinity_fabric_number": "TR-3644303",
  "lining_fabric_number": "LL-2617297",
  "description": "Black Solid",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/TR-3644303?hei=200",
  "active": true
}

Returns details on a specific label.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_pipings/:id

Query Parameters

Parameter Default Description
id N/A The specific piping id you want to see

Other

Get All Suedes

curl "https://api.trinity-apparel.com/v1/suedes"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "value": "MS-219183_silver",
    "description": "7-02 Silver",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-02_Silver?&hei=100",
    "rgb": "212,212,212",
    "display_order": 2,
    "active": true
  },
  {
    "value": "MS-219184_gray",
    "description": "7-03 Gray",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-03_Gray?&hei=100",
    "rgb": "111,98,110",
    "display_order": 3,
    "active": true
  },
  {
    "value": "MS-219185_charcoal",
    "description": "7-04 Charcoal",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-04_Charcoal?&hei=100",
    "rgb": "85,83,83",
    "display_order": 4,
    "active": true
  },
  {
    "value": "MS-219186_black",
    "description": "7-05 Black",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-05_Black?&hei=100",
    "rgb": "0,0,0",
    "display_order": 5,
    "active": true
  },
  {
    "value": "MS-219187_lt__blue",
    "description": "7-08 Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-08_Blue?&hei=100",
    "rgb": "37,53,97",
    "display_order": 8,
    "active": true
  },
  {
    "value": "MS-219188_blue",
    "description": "7-07 Navy",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-07_Navy?&hei=100",
    "rgb": "56,57,73",
    "display_order": 7,
    "active": true
  },
  {
    "value": "MS-219189_navy",
    "description": "7-06 Midnight Blue",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-06_Midnight_Blue?&hei=100",
    "rgb": "41,37,49",
    "display_order": 6,
    "active": true
  },
  {
    "value": "MS-219190_olive",
    "description": "7-39 Olive",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-39_Olive?&hei=100",
    "rgb": "99,94,76",
    "display_order": 39,
    "active": true
  },
  {
    "value": "MS-219191_camel",
    "description": "7-22 Sand",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-22_Sand?&hei=100",
    "rgb": "198,173,143",
    "display_order": 22,
    "active": true
  },
  {
    "value": "MS-219192_brown",
    "description": "7-25 Mocha",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-25_Mocha?&hei=100",
    "rgb": "106,69,39",
    "display_order": 25,
    "active": true
  },
  {
    "value": "MS-219193_chocolate",
    "description": "7-26 Dark Brown",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-26_Dark_Brown?&hei=100",
    "rgb": "56,43,32",
    "display_order": 26,
    "active": true
  },
  {
    "value": "MS-219194_rust",
    "description": "7-28 Orange",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-28_Orange?&hei=100",
    "rgb": "195,82,49",
    "display_order": 28,
    "active": true
  },
  {
    "value": "MS-219195_mahogany",
    "description": "7-27 Rust",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-27_Rust?&hei=100",
    "rgb": "135,55,38",
    "display_order": 27,
    "active": true
  },
  {
    "value": "MS-219196_burgundy",
    "description": "7-16 Burgundy",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-16_Burgundy?&hei=100",
    "rgb": "112,31,38",
    "display_order": 16,
    "active": true
  },
  {
    "value": "MS-219197_maroon",
    "description": "7-15 Maroon",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-15_Maroon?&hei=100",
    "rgb": "89,39,54",
    "display_order": 15,
    "active": true
  },
  {
    "value": "MS-219198_purple",
    "description": "7-14 Purple",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-14_Purple?&hei=100",
    "rgb": "92,59,87",
    "display_order": 14,
    "active": true
  },
  {
    "value": "MS-219199_lavender",
    "description": "7-13 Lavender",
    "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-13_Lavender?&hei=100",
    "rgb": "197,179,223",
    "display_order": 13,
    "active": true
  }
]

Returns an array of active suedes.

HTTP Request

GET https://api.trinity-apparel.com/v1/suedes

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive suedes.
description N/A If set, will return any suedes with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid suedes for that option value.

Other

Querying by multiple suede descriptions

In order to query for multiple suedes, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/suedes?description[]=7-03 Gray&description[]=7-05 Black&description[]=7-06 Midnight Blue

Get a Specific Suede

curl "https://api.trinity-apparel.com/v1/suedes/MS-219187_lt__blue"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "value": "MS-219187_lt__blue",
  "description": "7-08 Blue",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-08_Blue?&hei=100",
  "rgb": "37,53,97",
  "display_order": 8,
  "active": true
}

Returns details on a specific suede.

HTTP Request

GET https://api.trinity-apparel.com/v1/suedes/:value

Query Parameters

Parameter Default Description
value N/A The specific suede value you want to see

Other

Get All Threads

curl "https://api.trinity-apparel.com/v1/material_theads"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "value": "black",
    "code": "C9770",
    "description": "Black",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=36,36,36&fmt=png-alpha",
    "rgb": "36,36,36",
    "display_order": 4,
    "active": 1
  },
  {
    "value": "navy",
    "code": "C7930",
    "description": "Navy",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=28,33,50&fmt=png-alpha",
    "rgb": "28,33,50",
    "display_order": 8,
    "active": 1
  },
  {
    "value": "ivory",
    "code": "C2740",
    "description": "Ivory",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=245,247,237&fmt=png-alpha",
    "rgb": "245,247,237",
    "display_order": 21,
    "active": 1
  },
  {
    "value": "light_gray",
    "code": "C9631",
    "description": "Light Gray",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=172,167,172&fmt=png-alpha",
    "rgb": "172,167,172",
    "display_order": 7,
    "active": 1
  },
  {
    "value": "medium_gray",
    "code": "C9623",
    "description": "Medium Gray",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=153,156,158&fmt=png-alpha",
    "rgb": "153,156,158",
    "display_order": 6,
    "active": 1
  },
  {
    "value": "dark_gray",
    "code": "C9949",
    "description": "Dark Gray",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=110,111,112&fmt=png-alpha",
    "rgb": "110,111,112",
    "display_order": 5,
    "active": 1
  },
  {
    "value": "trinity_blue",
    "code": "C7305",
    "description": "Trinity Blue",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=40,81,147&fmt=png-alpha",
    "rgb": "40,81,147",
    "display_order": 11,
    "active": 1
  },
  {
    "value": "blue",
    "code": "C7201",
    "description": "Blue",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=139,187,226&fmt=png-alpha",
    "rgb": "139,187,226",
    "display_order": 33,
    "active": 1
  },
  {
    "value": "light_blue",
    "code": "C7279",
    "description": "Light Blue",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=162,196,204&fmt=png-alpha",
    "rgb": "162,196,204",
    "display_order": 10,
    "active": 1
  },
  {
    "value": "dark_brown",
    "code": "C8989",
    "description": "Dark Brown",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=94,70,61&fmt=png-alpha",
    "rgb": "94,70,61",
    "display_order": 14,
    "active": 1
  },
  {
    "value": "medium_brown",
    "code": "C8587",
    "description": "Medium Brown",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=175,129,86&fmt=png-alpha",
    "rgb": "175,129,86",
    "display_order": 15,
    "active": 1
  },
  {
    "value": "light_brown",
    "code": "C8501",
    "description": "Light Brown",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=214,176,137&fmt=png-alpha",
    "rgb": "214,176,137",
    "display_order": 18,
    "active": 1
  },
  {
    "value": "khaki",
    "code": "C2376",
    "description": "Khaki",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=237,200,147&fmt=png-alpha",
    "rgb": "237,200,147",
    "display_order": 13,
    "active": 1
  },
  {
    "value": "tan",
    "code": "C9313",
    "description": "Tan",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=209,190,170&fmt=png-alpha",
    "rgb": "209,190,170",
    "display_order": 12,
    "active": 1
  },
  {
    "value": "gold",
    "code": "C1257",
    "description": "Gold",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=253,216,121&fmt=png-alpha",
    "rgb": "253,216,121",
    "display_order": 25,
    "active": 1
  },
  {
    "value": "medium_olive",
    "code": "C5744",
    "description": "Medium Olive",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=131,130,52&fmt=png-alpha",
    "rgb": "131,130,52",
    "display_order": 12,
    "active": 1
  },
  {
    "value": "orange",
    "code": "C2427",
    "description": "Orange",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=255,137,38&fmt=png-alpha",
    "rgb": "255,137,38",
    "display_order": 0,
    "active": 1
  },
  {
    "value": "red",
    "code": "C3853",
    "description": "Red",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=182,33,28&fmt=png-alpha",
    "rgb": "182,33,28",
    "display_order": 24,
    "active": 1
  },
  {
    "value": "burgundy",
    "code": "C3993",
    "description": "Burgundy",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=122,40,41&fmt=png-alpha",
    "rgb": "122,40,41",
    "display_order": 0,
    "active": 1
  },
  {
    "value": "purple",
    "code": "C4983",
    "description": "Purple",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=69,43,81&fmt=png-alpha",
    "rgb": "69,43,81",
    "display_order": 0,
    "active": 1
  },
  {
    "value": "lavender",
    "code": "C4328",
    "description": "Lavender",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=133,109,155&fmt=png-alpha",
    "rgb": "133,109,155",
    "display_order": 19,
    "active": 1
  },
  {
    "value": "white",
    "code": "C1740",
    "description": "White",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=244,241,244&fmt=png-alpha",
    "rgb": "244,241,244",
    "display_order": 3,
    "active": 1
  },
  {
    "value": "charcoal",
    "code": "C9949",
    "description": "Charcoal",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=108,111,115&fmt=png-alpha",
    "rgb": "108,111,115",
    "display_order": 22,
    "active": 1
  },
  {
    "value": "silver",
    "code": "C9114",
    "description": "Silver",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=181,183,185&fmt=png-alpha",
    "rgb": "181,183,185",
    "display_order": 8,
    "active": 1
  },
  {
    "value": "beige",
    "code": "C1172",
    "description": "Beige",
    "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=233,232,128&fmt=png-alpha",
    "rgb": "233,232,128",
    "display_order": 30,
    "active": 1
  }
]

Returns an array of active threads.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_threads

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive threads.
code N/A If set, will return any threads with exact matching code.
description N/A If set, will return any threads with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid threads for that option value.

Other

Querying by multiple thread descriptions or codes

In order to query for multiple threads, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/material_threads?description[]=Black&description[]=Medium Gray&description[]=Trinity Blue

OR

GET https://api.trinity-apparel.com/v1/material_threads?code[]=C9770&code[]=C9949&code[]=C7305

Get a Specific Thread

curl "https://api.trinity-apparel.com/v1/material_threads/trinity_blue"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "value": "trinity_blue",
  "code": "C7305",
  "description": "Trinity Blue",
  "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Colorcolor=40,81,147&fmt=png-alpha",
  "rgb": "40,81,147",
  "display_order": 11,
  "active": 1
}

Returns details on a specific thread.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_threads/:value

Query Parameters

Parameter Default Description
value N/A The specific thread value you want to see

Other

Get All Trouser Trims

curl "https://api.trinity-apparel.com/v1/material_trouser_trims"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 1,
    "value": "white_blue_micro_floral",
    "description": "White Blue Micro Floral",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/white_blue_micro_floral.jpg",
    "display_order": 5,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 2,
    "value": "blue_red_micro_design",
    "description": "Blue Red Micro Design",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/blue_red_micro_design.jpg",
    "display_order": 6,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 3,
    "value": "white_navy_micro_geometric",
    "description": "White Navy Micro Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/white_navy_micro_geometric.jpg",
    "display_order": 7,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 4,
    "value": "white_lt_blue_micro_floral",
    "description": "White Light Blue Micro Floral",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/white_lt_blue_micro_floral.jpg",
    "display_order": 8,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 5,
    "value": "blue_navy_micro_geometric",
    "description": "Blue Navy Micro Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/blue_navy_micro_geometric.jpg",
    "display_order": 9,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 6,
    "value": "midnight_white_micro_floral",
    "description": "Midnight White Micro Floral",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/midnight_white_micro_floral.jpg",
    "display_order": 10,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 7,
    "value": "blue_tan_geometric",
    "description": "Blue Tan Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/blue_tan_geometric.jpg",
    "display_order": 11,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 8,
    "value": "blue_navy_melange_geometric",
    "description": "Blue Navy Melange Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/blue_navy_melange_geometric.jpg",
    "display_order": 12,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 9,
    "value": "grey_navy_melange_geometric",
    "description": "Grey Navy Melange Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/grey_navy_melange_geometric.jpg",
    "display_order": 13,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 10,
    "value": "navy_grey_melange_geometric",
    "description": "Blue Grey Melange Geometric",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/navy_grey_melange_geometric.jpg",
    "display_order": 14,
    "active": true,
    "created_at": "2022-02-21T12:12:10.000Z",
    "updated_at": "2022-02-21T12:12:10.000Z"
  },
  {
    "id": 11,
    "value": "black",
    "description": "Black",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/pants/waistband_color/black.jpg",
    "display_order": 3,
    "active": true,
    "created_at": "2022-02-24T16:23:20.000Z",
    "updated_at": "2022-02-24T16:23:20.000Z"
  },
  {
    "id": 12,
    "value": "ivory",
    "description": "Ivory",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/pants/waistband_color/ivory.jpg",
    "display_order": 4,
    "active": true,
    "created_at": "2022-02-24T16:23:20.000Z",
    "updated_at": "2022-02-24T16:23:20.000Z"
  }
]

Returns an array of active trouser trims.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_trouser_trims

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive trouser trims.
description N/A If set, will return any trouser trims with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid trouser trims for that option value.

Other

Querying by multiple trouser trim descriptions

In order to query for multiple threads, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/material_trouser_trims?description[]=Black&description[]=Ivory&description[]=Blue Tan Geometric

Get a Specific Trouser Trim

curl "https://api.trinity-apparel.com/v1/material_trouser_trims/7"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 7,
  "value": "blue_tan_geometric",
  "description": "Blue Tan Geometric",
  "image": "https://trinity-apparel.s3.amazonaws.com/option_images/materials/trouser_trims/blue_tan_geometric.jpg",
  "display_order": 11,
  "active": true,
  "created_at": "2022-02-21T12:12:10.000Z",
  "updated_at": "2022-02-21T12:12:10.000Z"
}

Returns details on a specific trouser trim.

HTTP Request

GET https://api.trinity-apparel.com/v1/material_trouser_trims/:id

Query Parameters

Parameter Default Description
id N/A The specific trouser trim id you want to see

Other

Get All Zippers

curl "https://api.trinity-apparel.com/v1/zippers"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 1,
    "value": "black",
    "description": "Black",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/black.jpg",
    "display_order": 3,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 2,
    "value": "medium_grey",
    "description": "Medium Grey",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/dark_gray.jpg",
    "display_order": 4,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 3,
    "value": "pewter",
    "description": "Pewter",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/light_gray.jpg",
    "display_order": 5,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 4,
    "value": "navy",
    "description": "Navy",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/dark_blue.jpg",
    "display_order": 6,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 5,
    "value": "medium_blue",
    "description": "Medium Blue",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/light_blue.jpg",
    "display_order": 7,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 6,
    "value": "tan",
    "description": "Tan",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/light_brown.jpg",
    "display_order": 8,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 7,
    "value": "brown",
    "description": "Brown",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/dark_brown.jpg",
    "display_order": 9,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 8,
    "value": "olive",
    "description": "Olive",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/dark_green.jpg",
    "display_order": 10,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  },
  {
    "id": 9,
    "value": "burgundy",
    "description": "Burgundy",
    "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/maroon.jpg",
    "display_order": 11,
    "active": true,
    "created_at": "2021-10-27T15:18:40.000Z",
    "updated_at": "2021-10-27T15:18:40.000Z"
  }
]

Returns an array of active zippers.

HTTP Request

GET https://api.trinity-apparel.com/v1/zippers

Query Parameters

Parameter Default Description
show_archived false If set to true, the result will also include inactive zippers.
description N/A If set, will return any zippers with exact matching descriptions.
q N/A If set, return all fuzzy matched descriptions.
option_value_id N/A If set, returns all valid zippers for that option value.

Other

Querying by multiple zipper descriptions

In order to query for multiple threads, you will pass in multiple params with the format like below:

GET https://api.trinity-apparel.com/v1/zippers?description[]=Olive&description[]=Black&description[]=Medium Grey

Get a Specific Zipper

curl "https://api.trinity-apparel.com/v1/zippers/3"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 3,
  "value": "pewter",
  "description": "Pewter",
  "image": "https://trinity-apparel.s3.amazonaws.com/option_images/zippers/light_gray.jpg",
  "display_order": 5,
  "active": true,
  "created_at": "2021-10-27T15:18:40.000Z",
  "updated_at": "2021-10-27T15:18:40.000Z"
}

Returns details on a specific zipper.

HTTP Request

GET https://api.trinity-apparel.com/v1/zippers/:id

Query Parameters

Parameter Default Description
id N/A The specific zipper id you want to see

Other

Update Fabric Match

curl -X POST "https://api.trinity-apparel.com/v1/garments/:id/fabric_match"
  -H "Authorization Bearer: swaledale"

The above command returns Garment Properties JSON structured like this:

{
  "measurements": [
{
      "id": 2,
      "name": "height",
      "description": "Height",
      "value": 182.88,
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 7,
      "garment_types": [
        "csc",
        "cv",
        "ct"
      ],
      "units": "cm"
    },

    ...
  ],
  "options": [
{
      "option": {
        "id": 1,
        "name": "garment_label",
        "description": "Garment Label"
      },
      "option_value": {
        "id": 374,
        "value": "dealer_label",
        "description": "用客供商标"
      },
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },

    ...
  ],

  "materials": {
    "fabrics": [
      {
        "id": 73096,
        "name": "K4-3973096",
        "description": "Black Fancy Solid",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/K4-3973096",
        "options": [
          {
            "id": null,
            "name": "shell",
            "description": "Shell Fabric",
            "garment_type": 5,
            "garment_types": [
              "csc",
              "ct"
            ]
          }
        ],
        "usage": "shell",
        "trinity_number": "K4-3973096",
        "supplier_number": "C21125-01",
        "quantity": {
          "cad": {
            "width": null,
            "length": null,
            "is_cut": null
          },
          "received": {
            "width": null,
            "length": null,
            "notes": null
          },
          "repeated_pattern": {
            "width": null,
            "length": null,
            "type": null
          }
        }
      },
      ...
    ],
      ...
    "buttons": [
      {
        "id": 2,
        "name": "KYKW024_Cinnamon",
        "description": "2-11 Cinnamon Marbled Premium",
        "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-11_Cinnamon_Marbled_Premium?wid=100",
        "options": [
          {
            "id": 21,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          {
            "id": 244,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          },
          {
            "id": 290,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 2,
            "garment_types": [
              "cv"
            ]
          },
          {
            "id": 507,
            "name": "materials_button_color",
            "description": "Button Color",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          {
            "id": 512,
            "name": "materials_button_color",
            "description": "Button Color/Type",
            "garment_type": 2,
            "garment_types": [
              "cv"
            ]
          },
          {
            "id": 516,
            "name": "materials_button_color",
            "description": "Button Color/Type",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          }
        ],
        "quantity": {
          "32L": {
            "csc": 3
          },
          "24L": {
            "csc": 16,
            "cv": 8,
            "ct": 3
          }
        }
      }
    ],
    "threads": [
      {
        "id": 27,
        "name": "silver",
        "description": "Silver",
        "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=231,231,231&fmt=png-alpha",
        "options": [
          {
            "id": 225,
            "name": "pic_stitching_lining_edge",
            "description": "Pic Stitching - Lining Edge",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          ...
        ]
      }
    ],
    "suedes": [],
    "labels": [
      {
        "id": 11,
        "name": "direct_embroider_lining",
        "description": "Embroider Directly on Garment Lining",
        "image": "http://s7d4.scene7.com/is/image/trinityapparel/Embroidery_Lining?wid=300",
        "options": [
          {
            "id": 84,
            "name": "customer_label",
            "description": "Coat Name Label",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          }
        ]
      },
      ...
    ],
    "pocket_bags": [
      {
        "id": null,
        "name": "front_pocket_l",
        "description": "Default Front Left Pocket Bag",
        "image": null,
        "options": [
          {
            "id": null,
            "name": "front_pockets",
            "description": "front_pockets",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          }
        ],
        "quantity": {
          "length": 14.57,
          "width": 7.87
        }
      },
      ...
    ],
    "dealer_labels": [
      {
        "id": "TAGDL-0264",
        "name": "Well Suited Custom Clothiers 813-545-2700",
        "description": "[\"7.9\", \"4\"]",
        "image": "https://workflow.trinity-apparel.com/images/labels/TAGDL-0264.jpg",
        "options": [
          {
            "id": 1,
            "name": "garment_label",
            "description": "Garment Label",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          }
        ],
        "quantity": 1,
        "dealer_id": 952,
        "size": {
          "width": "7.9",
          "length": "4"
        }
      }
    ]
  },
  "special_instructions": [
    {
        "garment_type": 8,
        "instruction": "The cuff is a non fold french to be used with cufflinks.  3 buttonholes no buttons",
        "translation": null
    }
  ]
}

Description

This call updates or creates a record to match materials to a fabric.

Once the record is created, it will return an updated garment properties JSON that will include these newly matched materials.

Rules

The ID of at least one material type must be provided (Button, Felt, Thread, Suede). The ID that is passed must also be an active material in our system otherwise an error will be returned.

We will first check for an exsiting fabric match record and update it with the params passed or create a new record if none exists.

To get valid lining IDs, use the fabric API with the following params:

GET https://api.trinity-apparel.com/v1/fabrics?is_active=1&named_filter=lining&collection_id=1356&pattern_id=1&per_page=32

For the other materials, use the relevant API call to fetch valid IDs: Buttons, Felts, Threads, Suedes.

HTTP Request

POST https://api.trinity-apparel.com/v1/garments/:id/fabric_match

Query Parameters

Parameter Default Description
id N/A The specific garment you want to add a match for the fabric and get an updated properties on
lining_fabric_id N/A The ID of the lining fabric you want to match
button_id N/A The ID of the button you want to match
outerwear_button_id N/A The ID of the outerwear button you want to match
felt_id N/A The ID of the felt you want to match
thread_id N/A The ID of the thread you want to match
suede_id N/A The ID of the suede you want to match

Other

Responses

Response Code Description
200 Fabric match was successfully updated/created
403 Not Authorized - You're not a factory
409 There was an error. Reason provided in JSON

Customers API

Customer Resources

The customers API will return detailed information about customers you have created in Workflow. Here is a detailed list of attributes in those resources:

Customer

# Standard Object - Used in a resource collection
{
  "id": 293,
  "name": "Jakob Causey",
  "home_phone": "617-608-2771",
  "cell": "555-555-1234",
  "email": "jakob_upto6@hotmail.com"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object.
name
string
The customers first and last name combined.
home_phone
string
The customer's home phone number.
cell
string
The customer's mobile phone number.
email
string
The customer's email address.
# Extended Object
{
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com",
    "first_name": "Jakob",
    "last_name": "Causey",
    "created_at": "2019-02-13T11:12:56.000Z",
    "address1": "4809 Cedar Lane",
    "address2": null,
    "city": "Boston",
    "state": "MA",
    "zip": "02210",
    "country": "USA",
    "work_phone": null,
    "fax": null,
    "company": "Erlebacher",
    "gender": "male",
    "receive_email_promos": true,
    "receive_mail_promos": true,
    "name_label": "JCausey",
    "laundry_marker": "JCausey",
    "monogram": "JC",
    "notes": "Athletic build",
    "dealer_personal": false
}

Extended attributes

Attribute Description
first_name
string
The customer's first name.
last_name
string
The customer's last name.
created_at
datetime
The date the customer was added to Workflow.
address1
string
The customer's first address line.
address2
string
The customer's second address line.
city
string
The city of the customer's address.
state
string
The state of the customer's address.
zip
string
The zip code of the customer's address.
country
string
The country of the customer's address.
work_phone
string
The customer's work phone number.
fax
string
The customer's fax number.
company
string
The customer's company.
gender
string
The gender of the customer.
receive_email_promos
boolean
If the customer has opted to receive email promos.
receive_mail_promos
boolean
If the customer has opted to receive mail promos.
name_label
string
The customer's preferred name label.
laundry_marker
string
The customer's preferred laundry marker.
monogram
string
The customer's preferred monogram.
notes
string
Notes about the customer.
dealer_personal
boolean
If this customer is a personal account of the dealer.
# Dashboard Object
{
    "id": 121008,
    "first_order": null,
    "last_order": null,
    "name": "Rapid Replenishment",
    "total_orders": 0,
    "total_garments": null
}

Dashboard attributes

Attribute Description
id
integer
Unique identifier for the object.
first_order
datetime
Date of the first order. Null if no orders exist
last_order
datetime
Date of the last order. Null if no orders exist
name
string
The customers first and last name combined.
total_orders
integer
Lifetime count of dealer orders for this customer
total_garments
integer
Lifetime count of garments ordered by this customer

Get All Customers

curl "https://api.trinity-apparel.com/v1/customers"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
  {
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com"
  },
]

Returns an array of your customers.

HTTP Request

GET https://api.trinity-apparel.com/v1/customers

Query Parameters

Parameter Default Description
q N/A Fuzzy search. If set, returns only customers with names that contain the search term.
first_name N/A If set, will return results with exact matching first_name.
last_name N/A If set, will return results with exact matching last_name.
email N/A If set, will return results with exact matching email address.
city N/A If set, will return results with exact matching city.
state N/A If set, will return results with exact matching state.
zip N/A If set, will return results with exact matching zip code.
country N/A If set, will return results with exact matching country.
extended false If true, the API call returns extended objects which include a complete set of attributes and subresources.

Other

Customer Dashboard

curl "https://api.trinity-apparel.com/v1/customers/dashboard"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 121008,
        "first_order": null,
        "last_order": null,
        "name": "Rapid Replenishment",
        "total_orders": 0,
        "total_garments": null
    },
    {
        "id": 134420,
        "first_order": "2019-04-21T23:09:04.000Z",
        "last_order": "2019-04-21T23:09:04.000Z",
        "name": "Tony Stark",
        "total_orders": 1,
        "total_garments": 2
    },
    {
        "id": 121009,
        "first_order": "2018-12-09T01:51:41.000Z",
        "last_order": "2019-07-10T03:32:25.000Z",
        "name": "Steve Rogers",
        "total_orders": 3,
        "total_garments": 4
    },
    {
        "id": 156012,
        "first_order": null,
        "last_order": null,
        "name": "Dr. Bruce Banner",
        "total_orders": 0,
        "total_garments": null
    },
    {
        "id": 122123,
        "first_order": null,
        "last_order": null,
        "name": "Peter Parker",
        "total_orders": 0,
        "total_garments": null
    },
    ...
]

Returns an array of your customers with metrics. Used in the Trinity clients page.

HTTP Request

GET https://api.trinity-apparel.com/v1/customers/dashboard

Query Parameters

Parameter Default Description
q N/A Fuzzy search. If set, returns only customers with names that contain the search term.
have_bought N/A Can only be true or false - Required for all filters except for q (see notes below).
start_date N/A The start of the date range you want to filter.
end_date N/A The end of the date range you want to filter.
garment_type[] N/A Array syntax of garment types you want to filter on (see notes below).

Notes On Filtering

You can filter customers based on a few limited parameters. First, the standard q param will only return customers with names matching the search term. This can be used independently of the other filters. In order to do any further filtering, you will have to pass in the have_bought, start_date and end_date params. You can also pass in the garment_type param using the array syntax. For the garment types, you must pass them in using their relevant bitmask. You can use the garment types list to see what the correct bitmask is.

Example Usage

If you were looking for all customers who HAVE NOT ordered any garments in the last 6 months, you would use the following query:

GET https://api.trinity-apparel.com/v1/customers/dashboard?have_bought=false&start_date=2020-01-01&end_date=2020-07-01

If you were looking for all customers who HAVE ordered vests and pants in the last year, you would use the following query:

GET https://api.trinity-apparel.com/v1/customers/dashboard?have_bought=true&start_date=2019-07-01&end_date=2020-07-01&garment_type[]=2&garment_type[]=4

Other

Export Customers

curl "https://api.trinity-apparel.com/v1/customers/dashboard.csv"
  -H "Authorization Bearer: swaledale"

The above command returns a CSV content-type that is structured like this:

id,name,created_at,company,email,street_1,street_2,city,state,zip,country,phone_cell,phone_work,phone_home,fax,first_order_date,last_order_date,total_orders,total_garments

19016,Rapid Replenishment,,,,,,,,,USA,,,,,2013-12-31 17:49:33 UTC,2016-06-30 08:37:18 UTC,2,36

145015,Ben Abernathy,2019-01-05 19:30:25 UTC,,,,,,,,USA,,,,,2019-01-05 13:38:33 UTC,2019-01-05 13:38:33 UTC,1,1

95861,Jeremy Abernathy,2016-10-05 20:38:37 UTC,,,,,,,,USA,,,,,2016-10-05 21:05:33 UTC,2016-10-05 21:05:33 UTC,1,3

2165,Neal Abernathy,,,,,,,AL,,USA,,,,,2006-09-06 09:15:24 UTC,2019-11-15 09:02:38 UTC,26,63

136184,Bill Acton,2018-07-31 16:44:51 UTC,,,,,,,,USA,,,,,2018-08-01 10:57:25 UTC,2019-03-15 15:23:43 UTC,4,8

68625,Jonathon Adams,2015-06-03 15:28:58 UTC,,,,,,,,USA,,,,,2015-06-03 15:50:17 UTC,2018-09-06 15:20:34 UTC,3,5

32446,Tom Addario,,,,,,,,,USA,,,,,2012-04-03 09:25:36 UTC,2013-05-06 10:01:48 UTC,2,3

68169,Ralph Aldridge,2015-05-26 10:28:30 UTC,,,,,,,,USA,,,,,2015-05-29 15:37:13 UTC,2015-05-29 15:37:13 UTC,1,1

105698,Greg Allen,2017-03-25 14:55:44 UTC,,,,,,,,USA,,,,,2017-03-25 15:01:47 UTC,2017-03-28 10:52:51 UTC,2,2

Returns a CSV file that lists all of your customers with metrics. Used on the Trinity clients page.

The first row is a header. Each additional row contains comma delimited data for the following fields:

HTTP Request

GET https://api.trinity-apparel.com/v1/customers/dashboard.csv

Query Parameters

Parameter Default Description
q N/A Fuzzy search. If set, returns only customers with names that contain the search term.

Other

Get a Specific Customer

curl "https://api.trinity-apparel.com/v1/customers/293"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
    "id": 293,
    "name": "Jakob Causey",
    "first_name": "Jakob",
    "last_name": "Causey",
    "home_phone": "617-608-2771",
    "cell": "555-555-1234",
    "email": "jakob_upto6@hotmail.com",
    "created_at": "2019-02-13T11:12:56.000Z",
    "address1": "4809 Cedar Lane",
    "address2": null,
    "city": "Boston",
    "state": "MA",
    "zip": "02210",
    "country": "USA",
    "work_phone": null,
    "fax": null,
    "company": "Erlebacher",
    "gender": "male",
    "receive_email_promos": true,
    "receive_mail_promos": true,
    "name_label": "JCausey",
    "laundry_marker": "JCausey",
    "monogram": "JC",
    "notes": "Athletic build",
    "dealer_personal": false
}

Returns details on a specific customer.

HTTP Request

GET https://api.trinity-apparel.com/v1/customers/:id

Query Parameters

Parameter Default Description
id N/A The specific customer id you want to see

Other

Manufacturers API

The manufacturers API allows a factory to download all relevant information needed to produce a garment. Plus it allows the factory to update the status of a garment and add the garment to a shipment.

This includes:

Deprecated:

Order Processing Flow

Ready -> Blue Pencil -> Cutting -> Production -> Production Complete -> International Transit

Ready status

Garment can be downloaded if it is not in a delay status (trinity review of special instructions, etc). Downloading involves getting garment detail, garment properties, garment fabrics, and downloading the gerber files.

Once the garment is fully downloaded, the manufacturer should move the garment to Blue Pencil status (ID=4 or code=PENDING).

Blue Pencil status

In Blue Pencil status, the CAD team lays the marker, the order team puts the order in the production plan, and materials are gathered. Once the marker is complete, the factory should input the CAD measurements into Trinity Admin on the Fabric Cuts page: https://admin.trinity-apparel.com/fabric_cuts

When all fabric cut lengths are entered into the system, the garment will be automatically moved into cutting.

Cutting status

Once all fabrics (shell, lining, trims, etc) have been cut, the garment should be moved to Production status (ID=5 or code=PRODUCTION) using the set order status call.

Production status

During the production process we print care labels and hang tags. You will use our Windows applications to print these. These applications require internet connectivity to hit our api and get data about the garment.

For garments with embroidery, you need to use two Windows applications. One must be connected to a computer with the App Ethos software installed and have the App Ethos dongle. It cannot be a server and will not allow remote desktop connections while the app is running. Our app connects to our API and gets data about embroidery and generates an input file that app ethos uses to create a DST file. The file can either sit on a share drive or be moved manually using a USB key. The second embroidery app reads the DST files and provides them to a Brother embroidery machine.

Once production is complete and the garment is ready to ship. Please set the order status to production complete (ID=6 or code=MADE).

Production complete status

In the production complete status, we build a packing list using the create shipment call. We can add a tracking number immediately or add one at a later time. Once the shipment has a tracking number, we can move the garments to international transit (set status to ID=7 or code=SHIPDC).

International Transit status

Trinity will take the order from here. Once we receive the garment at a distribution center, we will move the status to final inspection.

Resources

The resources provided by the manufacturers API are almost identical to the orders API. Only the garment and dealer_order objects are different. Links to download Gerber input files and the order PDFs are included.

Garment

# Garment Object - Used in a resource collection
{
    "id": 845556,
    "title": "TEST-845556",
    "order_id": 386627,
    "copied_garment_id": null,
    "garment_type": "SWK",
    "prefix": "TEST",
    "index": "1",
    "created_at": "2018-04-24T21:17:23.000Z",
    "updated_at": null,
    "last_status_change_date": "2018-04-24T21:17:23.000Z",
    "last_delay_change_date": null,
    "links": {
        "gerber": "http://localhost:8080/share/order_insert.php?suit_ids[]=845556&units=uscust&format=gerber&fabtype=both",
        "order_insert": "https://trinity-apparel.com/share/order_insert.php?format=pdfzip&units=si&suit_ids%5B%5D=845556",
        "order_split": "https://documents.trinity-apparel.com/order_splits?garment_id=845556&locale=en"
    },
    "manufacturer": ...,
    "fabric":       ...,
    "order_status": ...,
    "delay_status": ...,
    "dealer_order": ...
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the object
title
string
Our SKU field which includes the garment id number and information about where the factory will send the garment
order_id
integer
Each garment must be a part of a specific order
copied_garment_id
integer
Garment id if this was copied from a previous order
garment_type
string
Type of garment. Click here for more info
prefix
string
First part of the title. This indicates where the order was made or where the factory will send the garment
index
string
Sequence number (1/7, 2/7, 3/7 ...) for each garment in an order. Each item has a different index
created_at
datetime
When the garment was first created (but not ordered)
updated_at
datetime
When the garment was last modified
last_status_change_date
datetime
When did the order status last change to a new state
last_delay_change_date
datetime
When did the delay status last change to a new state
links
subresource
Urls that allow the manufacturer to generate Gerber ASCII files, an Order Insert PDF, and an Order Split
manufacturer
subresource
Factory that made the order. Click here for more info
fabric
subresource
Shell fabric used in the order. Click here for more info
order_status
subresource
Current status of the order. Click here for more info
delay_status
subresource
If garment is delayed, this will return why. Click here for more info
dealer_order
subresource
The full order placed by a single customer. Includes this garment and can include more garments.

Dealer Order

# Order Object - Used in a resource collection
{
    "id": 386627,
    "title": "DO-386627",
    "custom_order_number": "",
    "garment_count": 0,
    "ship_type": "Ground",
    "measurement_units": "uscust",
    "ordered_at": null,
    "created_at": "2018-04-24T20:36:28.000Z",
    "invoiced_at": null
}

Standard Attributes

Attribute Description
id
string
Unique identifier for the object
title
string
Our SKU field for orders
custom_order_number
string
Dealers can set this field to whatever they want. It is typically the dealer's SKU or a summary of the order
garment_count
integer
How many garments are in the order. multi-piece garments (e.g., Suit) are counted as 1.
ship_type
string
How is the garment shipped to the final destination
measurement_units
string
Units can be uscust for US customary units (in) or si for metric units (cm)
ordered_at
datetime
Time that the dealer completed the checkout process and officially placed the order
created_at
datetime
Time when the dealer first began adding garments to the order
invoiced_at
datetime
Time of the first invoice

Embroidery

# Embroidery Object - Used in collections
{
    "garment": {
        "id": 1081783,
        "manufacturer_id": 4,
        "garment_type": 1,
        "created_at": "2019-11-03T18:47:22.000Z"
    },
    "option": {
        "id": 89,
        "name": "customer_label_text",
        "garment_type": 1,
        "garment_types": [
            "csc"
        ]
    },
    "text": "M Kiser",
    "font": "Calligraphy",
    "color": "5-01 White",
    "position": "T4 - Left Below Breast Pkt",
    "size": null
}
Attribute Description
garment
subresource
Limited info on the garment
fabric
subresource
Limited info on the fabric
text
string
Text for the embroidery
font
string
Embroidery font or Monogram selected
color
string
Thread color
position
string
Location for the embroidery; Only required for some embroidery options
size
string
Width of the embroidery

Embroidery Garment

# Minimal Garment Object - Used in embroidery
{
    "id": 1081783,
    "manufacturer_id": 4,
    "garment_type": 1,
    "created_at": "2019-11-03T18:47:22.000Z"
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the garment
manufacturer_id
integer
The factory who made the garment
garment_type
integer
Garment bitmask. Click here for more info
created_at
datetime
When the garment was first created (but not ordered)

Embroidery Option

# Minimal Option Object - Used in embroidery
{
    "id": 89,
    "name": "customer_label_text",
    "garment_type": 1,
    "garment_types": [
        "csc"
    ]
}

Standard Attributes

Attribute Description
id
integer
Unique identifier for the option
name
string
Option name. Typically refers to the location of the embroidery
garment_type
integer
Garment bitmask. Click here for more info
garment_types
array
List of human readable garment types
created_at
datetime
When the garment was first created (but not ordered)

Fabric Cut

# Fabric Cut Object - Used in collections
{
    "id": 540803,
    "is_cut": false,
    "created_at": "2019-10-28T07:25:55.000Z",
    "length": 415,
    "actual_length": 410,
    "width": 136,
    "garment": {
        "id": 1059195,
        "title": "ID-1059195",
        "created_at": "2019-09-13T06:23:02.000Z",
        "garment_type": "CCVP"
    },
    "fabric": {
        "id": 29938,
        "description": "Medium Blue Paisley",
        "trinity_fabric_number": "L6-3129938",
        "url": "https://s7d4.scene7.com/is/image/trinityapparel/L6-3129938",
        "has_image": true
    },
    "option": {
        "id": 229,
        "name": "lining_fabric_num",
        "description": "Lining Fabric #"
    }
}
Attribute Description
garment
subresource
Each garment record contains the id, title, date the garment was first entered into the system, and a garment type code
fabric
subresource
Limited info on the fabric (id, description trinity number, a url for a repeatable swatch image, and a boolean to show if the image is available)
fabric
subresource
Limited info on the option (id, name, and description). Can be null
id
integer
Unique identifier for the fabric cut
is_cut
boolean
Has the cut been made?
length
float
Length in centimeters (5 cm added to input, so the factory has overage)
actual_length
float
Actual length in centimeters
width
float
Width in centimeters
created_at
datetime
When was the cut record added

Download Garments

curl "https://api.trinity-apparel.com/v1/download_garments"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 1108277,
        "title": "ID-1108277",
        "order_id": 509309,
        "copied_garment_id": null,
        "garment_type": "CCVP",
        "prefix": "ID",
        "index": "1/1",
        "created_at": "2020-01-13T10:01:23.000Z",
        "updated_at": null,
        "last_status_change_date": "2020-01-13T10:04:34.000Z",
        "last_delay_change_date": null,
        "links": {
            "gerber": "http://localhost:8080/share/order_insert.php?suit_ids[]=1108277&units=uscust&format=gerber&fabtype=both",
            "order_insert": "https://trinity-apparel.com/share/order_insert.php?format=pdfzip&units=si&suit_ids%5B%5D=1108277",
            "order_split": "https://documents.trinity-apparel.com/order_splits?garment_id=1108277&locale=en"
        },
        "manufacturer": {
            "id": 5,
            "name": "Trisco TAM",
            "email": "info@trinity-apparel.com"
        },
        "fabric": {
            "id": 70215,
            "active": true,
            "description": "Blue Sharkskin",
            "supplier_fabric_number": "100325",
            "trinity_fabric_number": "TT-3970215",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/TT-3970215",
            "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=TT-3970215&res=300",
            "pattern_id": null,
            "weave_id": 15,
            "price_tier": null,
            "discount": null,
            "has_image": false,
            "favorite_id": null,
            "fabric_type": null,
            "fabric_garment_type": 711,
            "trim_garment_type": 0
        },
        "order_status": {
            "code": "READY",
            "name": "Pending",
            "description": "Ready"
        },
        "delay_status": {
            "code": "OK",
            "description": "Not Delayed"
        },
        "dealer_order": {
            "id": 509309,
            "title": "DO-509309",
            "custom_order_number": null,
            "garment_count": 1,
            "ship_type": "In-Store Pick-Up",
            "measurement_units": "uscust",
            "ordered_at": "2020-01-13T10:04:34.000Z",
            "created_at": "2020-01-13T10:00:47.000Z",
            "invoiced_at": null
        },
        "outgoing_address": {
            "id": 1,
            "contact_name": "Greg Traweek",
            "description": "Trinity USA",
            "street1": "227 Marketridge Dr",
            "street2": null,
            "street3": null,
            "city": "Ridgeland",
            "state": "MS",
            "zip": "39157",
            "country": "USA",
            "phone": "601-713-2628"
        }
    },
    {
        "id": 843257,
        "title": "TEST-843257",
        "order_id": 385194,
        "copied_garment_id": null,
        "garment_type": "CTOPC",
        "prefix": "TEST",
        "index": "",
        "created_at": "2018-04-19T18:14:30.000Z",
        "updated_at": null,
        "last_status_change_date": "2018-04-19T18:14:30.000Z",
        "last_delay_change_date": null,
        "links": {
            "gerber": "http://localhost:8080/share/order_insert.php?suit_ids[]=843257&units=uscust&format=gerber&fabtype=both",
            "order_insert": "https://trinity-apparel.com/share/order_insert.php?format=pdfzip&units=si&suit_ids%5B%5D=843257",
            "order_split": "https://documents.trinity-apparel.com/order_splits?garment_id=843257&locale=en"
        },
        "manufacturer": {
            "id": 5,
            "name": "Trisco TAM",
            "email": "info@trinity-apparel.com"
        },
        "fabric": {
            "id": 41888,
            "active": true,
            "description": "Blue Navy Twill",
            "supplier_fabric_number": "BT65153-11",
            "trinity_fabric_number": "C4-3441888",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/C4-3441888",
            "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=C4-3441888&res=300",
            "pattern_id": null,
            "weave_id": 7,
            "price_tier": 1,
            "discount": null,
            "has_image": true,
            "favorite_id": null,
            "fabric_type": null,
            "fabric_garment_type": 231,
            "trim_garment_type": 0
        },
        "order_status": {
            "code": "READY",
            "name": "Pending",
            "description": "Ready"
        },
        "delay_status": {
            "code": "OK",
            "description": "Not Delayed"
        },
        "dealer_order": {
            "id": 385194,
            "title": "DO-385194",
            "custom_order_number": "",
            "garment_count": 0,
            "ship_type": "Ground",
            "measurement_units": "uscust",
            "ordered_at": null,
            "created_at": "2018-04-18T12:28:50.000Z",
            "invoiced_at": null
        },
        "outgoing_address": {
            "id": 1,
            "description": "Trinity USA",
            "street1": "227 Marketridge Dr",
            "street2": null,
            "street3": null,
            "city": "Ridgeland",
            "state": "MS",
            "zip": "39157",
            "country": "USA",
            "phone": "601-713-2628"
        }
    },
    ...
]

Returns an array of garments that are ready for download.

Right after a customer places an order, Trinity validates the order and requests materials if needed. Once the order is validated and fabric is received, it moves out of a hold status and is ready for download. These garments are in Ready status and have no delay status.

We expect the manufacturer to get a list of garments, then get garment details, fabric, options and measurements info. Once this is obtained, they will move the order status to Blue Pencil, which means that the factory downloaded the order and is laying the marker and putting the order into the production plan. When those tasks are completed the order moves to Cutting and then to Production.

HTTP Request

GET https://api.trinity-apparel.com/v1/download_garments

Query Parameters

Parameter Default Description
garment_id N/A Filter the list to a specific garment_id or list of garment_ids (using garment_id[]= array style syntax)
manufacturer_id N/A If set, returns only garments from a specific manufacturer id

Other

Examples

Download from a specific manufacturer

GET https://api.trinity-apparel.com/v1/download_garments?manufacturer_id=4

Returns garments from a specific factory

Download specific garments

GET https://api.trinity-apparel.com/v1/download_garments?garment_id[]=1001234&garment_id[]=1002345&garment_id[]=1003456

Returns garments #1001234, #1002345, and #1003456 as long as they are in Ready status and have no delays.

Garment Properties

curl "https://api.trinity-apparel.com/v1/garments/:id/properties"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "measurements": [
{
      "id": 2,
      "name": "height",
      "description": "Height",
      "value": 182.88,
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 7,
      "garment_types": [
        "csc",
        "cv",
        "ct"
      ],
      "units": "cm"
    },
    {
      "id": 3,
      "name": "weight",
      "description": "Weight",
      "value": 78.46,
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 7,
      "garment_types": [
        "csc",
        "cv",
        "ct"
      ],
      "units": "kgs"
    },
    {
      "id": 6,
      "name": "coat_fit",
      "description": "Coat Fit",
      "value": "trim",
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },

    ...

    {
      "id": 276,
      "name": "round_back",
      "description": "Round Back",
      "value": "",
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },
    {
      "id": 289,
      "name": "lower_back_crotch",
      "description": "Lower Back Crotch",
      "value": "normal",
      "last_modified": "2019-06-27 14:05:57 UTC",
      "garment_type": 4,
      "garment_types": [
        "ct"
      ]
    }
  ],
  "options": [
{
      "option": {
        "id": 1,
        "name": "garment_label",
        "description": "Garment Label"
      },
      "option_value": {
        "id": 374,
        "value": "dealer_label",
        "description": "用客供商标"
      },
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },
    {
      "option": {
        "id": 2,
        "name": "vent_style",
        "description": "Vent Style"
      },
      "option_value": {
        "id": 7,
        "value": "side_vent",
        "description": "双开衩-标准24cm"
      },
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },
    {
      "option": {
        "id": 3,
        "name": "shoulder_style",
        "description": "Shoulder Style"
      },
      "option_value": {
        "id": 656,
        "value": "ultra_soft",
        "description": "超薄休闲肩"
      },
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },

    ...

    {
      "option": {
        "id": 234,
        "name": "formal_treatment_waistband",
        "description": "Formal Treatment Position - Waistband"
      },
      "option_value": {
        "id": 1503,
        "value": "no",
        "description": "绸缎腰面 - 无"
      },
      "garment_type": 4,
      "garment_types": [
        "ct"
      ]
    },

    ...

    {
      "option": {
        "id": 611,
        "name": "bottom_style",
        "description": "Bottom Style"
      },
      "option_value": {
        "id": 10645,
        "value": "pointed",
        "description": ""
      },
      "garment_type": 2,
      "garment_types": [
        "cv"
      ]
    }
  ],

  "materials": {
    "fabrics": [
      {
        "id": 73096,
        "name": "K4-3973096",
        "description": "Black Fancy Solid",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/K4-3973096",
        "options": [
          {
            "id": null,
            "name": "shell",
            "description": "Shell Fabric",
            "garment_type": 5,
            "garment_types": [
              "csc",
              "ct"
            ]
          }
        ],
        "usage": "shell",
        "trinity_number": "K4-3973096",
        "supplier_number": "C21125-01",
        "quantity": {
          "cad": {
            "width": null,
            "length": null,
            "is_cut": null
          },
          "received": {
            "width": null,
            "length": null,
            "notes": null
          },
          "repeated_pattern": {
            "width": null,
            "length": null,
            "type": null
          }
        }
      },
      ...
    ],
      ...
    "buttons": [
      {
        "id": 2,
        "name": "KYKW024_Cinnamon",
        "description": "2-11 Cinnamon Marbled Premium",
        "image": "http://s7d4.scene7.com/is/image/trinityapparel/2-11_Cinnamon_Marbled_Premium?wid=100",
        "options": [
          {
            "id": 21,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          {
            "id": 244,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          },
          {
            "id": 290,
            "name": "button_color",
            "description": "Button Color/Type",
            "garment_type": 2,
            "garment_types": [
              "cv"
            ]
          },
          {
            "id": 507,
            "name": "materials_button_color",
            "description": "Button Color",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          {
            "id": 512,
            "name": "materials_button_color",
            "description": "Button Color/Type",
            "garment_type": 2,
            "garment_types": [
              "cv"
            ]
          },
          {
            "id": 516,
            "name": "materials_button_color",
            "description": "Button Color/Type",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          }
        ],
        "quantity": {
          "32L": {
            "csc": {
              "quantity": 4,
              "options": []
            }
          },
          "24L": {
            "csc": {
              "quantity": 9,
              "options": [
                "Sleeve Vent - No Buttonholes, Kissing Sleeve Button Spacing"
              ]
            },
            "cv": {
              "quantity": 4,
              "options": []
            },
            "ct": {
              "quantity": 2,
              "options": [
                "7.6cm Round Extension - Hook & Bar, Buttonhole"
              ]
            }
          }
        },
        "automatched": true
      }
    ],
    "threads": [
      {
        "id": 27,
        "name": "silver",
        "description": "Silver",
        "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=231,231,231&fmt=png-alpha",
        "options": [
          {
            "id": 225,
            "name": "pic_stitching_lining_edge",
            "description": "Pic Stitching - Lining Edge",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          },
          ...
        ]
      }
    ],
    "suedes": [],
    "labels": [
      {
        "id": 11,
        "name": "direct_embroider_lining",
        "description": "Embroider Directly on Garment Lining",
        "image": "http://s7d4.scene7.com/is/image/trinityapparel/Embroidery_Lining?wid=300",
        "options": [
          {
            "id": 84,
            "name": "customer_label",
            "description": "Coat Name Label",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          }
        ]
      },
      ...
    ],
    "pocket_bags": [
      {
        "id": null,
        "name": "front_pocket_l",
        "description": "Default Front Left Pocket Bag",
        "image": null,
        "options": [
          {
            "id": null,
            "name": "front_pockets",
            "description": "front_pockets",
            "garment_type": 4,
            "garment_types": [
              "ct"
            ]
          }
        ],
        "quantity": {
          "length": 14.57,
          "width": 7.87
        }
      },
      ...
    ],
    "dealer_labels": [
      {
        "id": "TAGDL-0264",
        "name": "Well Suited Custom Clothiers 813-545-2700",
        "description": "[\"7.9\", \"4\"]",
        "image": "https://workflow.trinity-apparel.com/images/labels/TAGDL-0264.jpg",
        "options": [
          {
            "id": 1,
            "name": "garment_label",
            "description": "Garment Label",
            "garment_type": 1,
            "garment_types": [
              "csc"
            ]
          }
        ],
        "quantity": 1,
        "dealer_id": 952,
        "size": {
          "width": "7.9",
          "length": "4"
        }
      }
    ]
  },
  "special_instructions": [
    {
        "garment_type": 8,
        "instruction": "The cuff is a non fold french to be used with cufflinks.  3 buttonholes no buttons",
        "translation": null
    }
  ]
}

Returns an array of measurements, an array of options, an array of special_instructions, and a hash of materials. The materials hash includes fabrics, buttons, threads, labels, suedes, felts, pocket_bags, and dealer_labels, each of which contains an array of those type of materials.

How it Works

All measurements are flat objects that include the measurement name and value. We also include the description and last modified date, as well as the numeric garment type and an array of all garment types the measurement is valid used in this garment (E.g., height would be valid for each piece in a suit). When the measurement value is numeric, we convert it into the appropriate measurement units for the factory (typically SI) and list the units. Measurements are also adjusted to be finished. Synthetic measurements (measurements that the dealer did not enter) are calculated and inserted into this list.

All options include the option and option value. The option includes the id, name, and english description (there's no translation for the option). The option value includes the id, value, and a localized description (translated for the appropriate garment manufacturer for the order). We use the translation if available, if not we fallback to English. We also include the garment type (numeric bitmask) and an array of valid garment types (abbreviations). Synthetic options (not entered by the dealer) may also be inserted into the options list.

In addition to options, we also provide a list of all materials needed to make the garment. Materials include fabrics, buttons, threads, labels, suedes, felts, pocket bags, and dealer labels. We include information specific to that material type (Trinity fabric number, thread code, etc), id, name, description, and image, which is a web link that you can use to display the material. Fabrics have a usage field, which can be shell (main fabric), lining, trim, or other. We also include a list of all options that use this material.

For each button type, we also provide a quantity object. This object contains a key/value pair for each button size which is itself a key/value pair for each garment type which is an object that contains a quantity and options field. quantity is a numeric field that shows the number of buttons needed for that garment and options is an array of options where those buttons are used. If the quantity is null, then we were unable to calculate the button count for that particular button.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/properties

Query Parameters

Parameter Default Description
id N/A The specific garment you want information on

Other

Future Plans

We plan to provide quantities (measurements or counts) of all materials. We can also add filters and allow users to toggle localization (metric units, translations) if that is important.

Garment Properties - Materials

Garment properties includes custom objects in the materials hash. The materials object includes: fabrics, buttons, threads, suedes, felts, labels, pocket bags, and dealer labels.

Materials Fabrics

# Materials fabric object
{
  "id": 70218,
  "name": "TT-3970218",
  "description": "Lt Gray Solid",
  "image": "https://s7d4.scene7.com/is/image/trinityapparel/TT-3970218",
  "options": [
    {
      "id": null,
      "name": "shell",
      "description": "Shell Fabric",
      "garment_type": 5,
      "garment_types": [
        "csc",
        "ct"
      ]
    }
  ],
  "trinity_number": "TT-3970218",
  "supplier_number": "GV100-10",
  "quantity": {
    "cad": {
      "width": null,
      "length": null,
      "is_cut": null
    },
    "received": {
      "width": null,
      "length": null,
      "notes": null
    },
    "repeated_pattern": {
      "width": null,
      "length": null,
      "type": null
    }
  }
}

Array of unique fabrics used in the garment.

Attribute Description
id
integer
Unique identifier for the fabric.
name
string
Trinity Fabric Number
description
string
Text describing the colors and pattern of the fabric
image
string
Full url to an image of the fabric.
supplier_fabric_number
string
A unique identifier / SKU according to the fabric supplier
trinity_fabric_number
string
A unique identifier / SKU according to Trinity
options
subresource
List of options that the fabric is used in (shell is an option)
quantity
subresource
An array of measurements for the fabric

Quantity Subresource

CAD

Length and width determined by processing the order in Gerber

Attribute Description
length
float
Length in centimeters
width
float
Width in centimeters
is_cut
boolean
Has the fabric been cut?

Received

Length and width are measured when a single length of fabric is received. Does not apply to fabrics that are in factory inventory.

Attribute Description
length
float
Length in centimeters
width
float
Width in centimeters
notes
string
(optional) Notes about fabric that was received

Repeated Pattern

Length and width of the pattern (stripe, plaid, etc) when a fabric is received. Does not apply to fabrics that are in factory inventory. Does not apply to solids.

Attribute Description
length
float
Length in centimeters
width
float
Width in centimeters
type
string
Types are: Solid/Paisley, Stripes, 'Check 1 - Symmetric' and 'Check 2 - Asymmetric'

Materials Buttons

# Material Button object
{
  "id": 244,
  "name": "JD1692-D181_Medium_Gray",
  "description": "1-03 Medium Gray",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/1-03_Medium_Gray?wid=100",
  "options": [
    {
      "id": 208,
      "name": "sleeve_button_color",
      "description": "Sleeve Button Color",
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    },
    ...
  ],
  "quantity": {
    "32L": {
      "csc": {
        "quantity": 4,
        "options": []
      }
    },
    "24L": {
      "csc": {
        "quantity": 9,
        "options": [
          "Sleeve Vent - No Buttonholes, Kissing Sleeve Button Spacing"
        ]
      },
      "cv": {
        "quantity": 4,
        "options": []
      },
      "ct": {
        "quantity": 2,
        "options": [
          "7.6cm Round Extension - Hook & Bar, Buttonhole"
        ]
      }
    }
  },
  "automatched": true
}

Array of unique buttons used in the garment

Attribute Description
id
integer
Unique identifier for the button.
name
string
Supplier Number
description
string
Description of button used in ordering system.
image
string
Full url to an image of the button.
options
subresource
List of options that the button is used in.
quantity
subresource
An object of button counts and options for the garment

We separate each button size by using the Ligne scale. Inside each button size, we list the button count needed by garment type (E.g., csc for jacket) as well as an array of option descriptions that the buttons are used for.

Materials Threads

# Material Thread object
{
  "id": 1,
  "name": "black",
  "description": "Black",
  "image": "http://s7d4.scene7.com/ir/render/trinityapparelrender/buttonhole?wid=112&obj=Buttonhole/Color&color=27,27,27&fmt=png-alpha",
  "options": [
    {
      "id": 262,
      "name": "waistband_color",
      "description": "Waistband Fabric",
      "garment_type": 4,
      "garment_types": [
        "ct"
      ]
    }
  ]
}

Array of unique threads used in the garment

Attribute Description
id
integer
Unique identifier for the thread.
name
string
Supplier Number
description
string
Description of thread used in ordering system.
image
string
Full url to an image of the thread.
options
subresource
List of options that the thread is used in.

Materials Suedes

{
  "id": 3,
  "name": "MS-219185_charcoal",
  "description": "7-04 Charcoal",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/7-04_Charcoal?&hei=100",
  "options": [
    {
      "id": 447,
      "name": "microsuede_undercollar_color",
      "description": "Microsuede Undercollar",
      "garment_type": 1,
      "garment_types": ["csc"]
    }
  ]
}

Array of unique suedes used in the garment

Attribute Description
id
integer
Unique identifier for the suede.
name
string
Supplier Number
description
string
Description of suede used in ordering system.
image
string
Full url to an image of the suede.
options
subresource
List of options that the suede is used in.

Materials Labels

{
  "id": 15,
  "name": "light_gray_label",
  "description": "Light Gray Label",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/light_grey_label?wid=300",
  "options": [
    {
      "id": 84,
      "name": "customer_label",
      "description": "Coat Name Label",
      "garment_type": 1,
      "garment_types": ["csc"]
    }
  ]
}

Array of unique labels used in the garment

Attribute Description
id
integer
Unique identifier for the label.
name
string
Unique string for label
description
string
Description of label used in ordering system.
image
string
Full url to an image of the label.
options
subresource
List of options that the label is used in.

Materials Felts

# Material Felt object
{
  "id": 21,
  "name": "FLD-0630_light_gray",
  "description": "6-03 Light Gray",
  "image": "http://s7d4.scene7.com/is/image/trinityapparel/6-03_Light_Gray?&hei=100",
  "options": [
    {
      "id": 446,
      "name": "felt_undercollar_color",
      "description": "Felt Undercollar",
      "garment_type": 1,
      "garment_types": [
        "csc"
      ]
    }
  ]
}

Array of unique felts used in the garment

Attribute Description
id
integer
Unique identifier for the felt.
name
string
Supplier Number
description
string
Description of felt used in ordering system.
image
string
Full url to an image of the felt.
options
subresource
List of options that the felt is used in.

Materials Pocket Bags

# Material Pocket Bag object
{
  "id": null,
  "name": "front_pocket_l",
  "description": "Default Front Left Pocket Bag",
  "image": null,
  "options": [
    {
      "id": null,
      "name": "front_pockets",
      "description": "front_pockets",
      "garment_type": 4,
      "garment_types": [
        "ct"
      ]
    }
  ],
  "quantity": {
    "length": 14.57,
    "width": 7.87
  }
}

Array of pocket bags needed in the garment

Attribute Description
id
integer
Not set
name
string
Location of the pocket bag
description
string
Verbose description of the pocket bag (based on pocket type)
image
string
Not set
options
subresource
List of options that the felt is used in.
quantity
subresource
Length and width of the bag in inches.

There are currently four locations for pocket bags:

Some garments will not have back pockets, so there will not always be four pocket bags in the array.

Materials Dealer Labels

# Material Dealer Label object
{
    "id": "TAGDL-0264",
    "name": "Well Suited Custom Clothiers 813-545-2700",
    "description": "[\"7.9\", \"4\"]",
    "image": "https://workflow.trinity-apparel.com/images/labels/TAGDL-0264.jpg",
    "options": [
      {
        "id": 1,
        "name": "garment_label",
        "description": "Garment Label",
        "garment_type": 1,
        "garment_types": [
          "csc"
        ]
      }
    ],
    "quantity": 1,
    "dealer_id": 952,
    "size": {
      "width": "7.9",
      "length": "4"
    }
}

Array of unique felts used in the garment

Attribute Description
id
string
Unique SKU for the dealer label. Used for Trinity inventory
name
string
Dealer Name
description
string
Usually the size in centimeters: [length, width]
image
string
Full url to an image of the dealer label.
options
subresource
List of options that the dealer label is used in.
quantity
integer
Number of labels needed to make the garment
dealer_id
integer
Trinity Dealer ID - unique per dealer
size
subresource
length and width are extracted from the description field

Get All Embroidery

curl "https://api.trinity-apparel.com/v1/embroidery"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "garment": {
            "id": 1079766,
            "manufacturer_id": 4,
            "garment_type": 5,
            "created_at": "2019-10-30T09:32:14.000Z"
        },
        "option": {
            "id": 89,
            "name": "customer_label_text",
            "garment_type": 1,
            "garment_types": [
                "csc"
            ]
        },
        "text": "J WHITE",
        "font": "Copper Plate",
        "color": "5-06 Charcoal",
        "position": "T4 - Left Below Breast Pkt",
        "size": null
    },
    {
        "garment": {
            "id": 1079773,
            "manufacturer_id": 4,
            "garment_type": 5,
            "created_at": "2019-10-30T09:43:50.000Z"
        },
        "option": {
            "id": 89,
            "name": "customer_label_text",
            "garment_type": 1,
            "garment_types": [
                "csc"
            ]
        },
        "text": "MWJ",
        "font": "Calligraphy",
        "color": "5-65 Dark Olive",
        "position": "Undercollar Position",
        "size": null
    },
    {
        "garment": {
            "id": 1079774,
            "manufacturer_id": 4,
            "garment_type": 5,
            "created_at": "2019-10-30T09:45:37.000Z"
        },
        "option": {
            "id": 89,
            "name": "customer_label_text",
            "garment_type": 1,
            "garment_types": [
                "csc"
            ]
        },
        "text": "John Eden",
        "font": "Calligraphy",
        "color": "5-54 Gold",
        "position": "T2 - Left Above Breast Pkt",
        "size": null
    },
    {
        "garment": {
            "id": 1079782,
            "manufacturer_id": 4,
            "garment_type": 32,
            "created_at": "2019-10-30T09:58:27.000Z"
        },
        "option": {
            "id": 89,
            "name": "customer_label_text",
            "garment_type": 32,
            "garment_types": [
                "ctopc"
            ]
        },
        "text": "HEPPERMANN",
        "font": "Copper Plate",
        "color": "5-03 Light Gray",
        "position": "T4 - Left Below Breast Pkt",
        "size": null
    },
    ...
]

Returns an array of embroidery objects. There can be more than one embroidery per garment. The object includes minimal objects for garment and fabric, plus flattened option values for text, font, color, position and size of the embroidery. The list is ordered by when the garments were created.

Click here for details on the response objects.

HTTP Request

GET https://api.trinity-apparel.com/v1/embroidery

Query Parameters

Parameter Default Description
garment_id N/A One or more garment ids. Use array style syntax garment_id[] for multiple.
start_date N/A Start of date range. Must be ISO-8601 date (YYYY-MM-DD)
end_date N/A End of date range. Must be ISO-8601 date (YYYY-MM-DD)
order_status_code N/A Filter using a single order status

A garment id, list of garment ids, or a date range (start and end date) must be provided.

NOTE: If specific garment(s) are not provided AND an order status is not provided, we filter by production statuses: STATUS_READY, STATUS_BLUE_PENCIL, STATUS_CUTTING, STATUS_PRODUCTION

Other

Examples

Embroidery for multiple garments

GET https://api.trinity-apparel.com/v1/embroidery?garment_id[]=1001234&garment_id[]=1002345&garment_id[]=1003456

Returns garments #1001234, #1002345, and #1003456

Embroidery for garments ordered on a specific day

GET https://api.trinity-apparel.com/v1/embroidery?start_date=2019-10-30&end_date=2019-10-30

Returns garments ordered on a specific day, October 30th.

Embroidery for garments ordered on a specific day and order status

GET https://api.trinity-apparel.com/v1/embroidery?start_date=2019-10-30&end_date=2019-10-30&order_status_code=PREP

Returns garments in Blue Pencil (code = PREP) status that were ordered on a specific day, October 30th.

Get Specific Embroidery

curl "https://api.trinity-apparel.com/v1/garments/:id/embroidery"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
  {
    "garment": {
      "id": 1081783,
      "manufacturer_id": 4,
      "garment_type": 1,
      "created_at": "2019-11-03T18:47:22.000Z"
    },
    "option": {
      "id": 89,
      "name": "customer_label_text",
      "garment_type": 1,
      "garment_types": ["csc"]
    },
    "text": "M Kiser",
    "font": "Calligraphy",
    "color": "5-01 White",
    "position": "T4 - Left Below Breast Pkt",
    "size": null
  }
]

Returns an array of embroidery objects. There can be more than one embroidery per garment. The object includes minimal objects for garment and fabric, plus flattened option values for text, font, color, position and size of the embroidery.

Click here for details on the response objects.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/fabrics

Query Parameters

Parameter Default Description
id N/A The specific garment you want fabrics for

Other

Update Fabric

curl -X POST "https://api.trinity-apparel.com/v1/fabrics/:id"
  -H "Authorization Bearer: swaledale"

The above command returns a 202 Accepted and no JSON output when it is successful.

Description

This call updates a fabric. Manufacturers will regularly update fabric attributes when a fabric is received.

Rules

All non-CMT fabrics can be modified.

Pattern Measurement rules:

HTTP Request

GET https://api.trinity-apparel.com/v1/fabrics/:id

Query Parameters

Parameter Default Description
id N/A id number for the fabric
fabric_weight_grams_meter N/A Weight of a meter of fabric, in grams
cuttable_width N/A Cuttable Width in inches (in)
pattern_type N/A solid, stripe, check_symmetric, or check_asymmetric
pattern_width N/A Width of the repeated pattern in inches (in)
width_offset N/A optional. Widthwize offset of the repeated pattern in inches (in)
pattern_length N/A Length of the repeated pattern in inches (in)
length_offset N/A optional. Lengthwise Offset of the repeated pattern in inches (in)
grain_repeat N/A boolean; Are there lines parallel to the grain that repeat?
crosswise_repeat N/A boolean; Are there lines perpindicular to the grain that repeat?
one_way_nap N/A boolean; Does the fabric appear different from one side? Affects corduroys and velvets. Marker pieces can't be mirrored on a one way nap
horiz_pattern N/A boolean; Is the repeat naturally horizontal?
non_iron N/A boolean; True if the fabric cannot be ironed.

Other

Responses

Response Code Description
201 Fabric was successfully changed
403 Not Authorized - You're not a factory
409 Unable to update the fabric. Reason provided in JSON

Create Stocked Fabric Cut

curl -X POST "https://api.trinity-apparel.com/v1/manufacturer_fabric_cuts"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 6,
  "sku_id": 1,
  "garment_id": 123,
  "length": "2.45",
  "is_recut": false,
  "updated_at": "2025-04-21T20:53:20.000Z",
  "created_at": "2025-04-21T20:53:20.000Z"
}

Description

This call tracks the length (in meters) of fabric that is cut from a bolt of stocked fabric in order to be used on a garment.

HTTP Request

POST https://api.trinity-apparel.com/v1/manufacturer_fabric_cuts

Query Parameters

Parameter Default Description
garment_id N/A Garment ID
supplier_number N/A Supplier number of cut fabric
meters N/A Fabric length in meters
is_recut false Boolean. Denotes if this is a recut of the fabric due to an issue with the previous cut (flawed fabric, too short, etc)

Other

Responses

Response Code Description
201 Stocked fabric cut entry was created
403 Error: Not Authorized - You're not a factory
409 Error: Unable to create a fabric cut. Error message is provided

Create Fabric Cut

curl -X POST "https://api.trinity-apparel.com/v1/fabric_cuts"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 546845,
  "is_cut": false,
  "created_at": "2019-11-14T22:09:36.000Z",
  "length": 1342,
  "actual_length": 1337,
  "width": 13,
  "garment": {
    "id": 1004082,
    "title": "ID-1004082",
    "created_at": "2019-04-30T17:23:39.000Z",
    "garment_type": "CSC"
  },
  "fabric": {
    "id": 54926,
    "description": "Grey Charcoal Twill",
    "trinity_fabric_number": "C4-3754926",
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/C4-3754926",
    "has_image": true
  },
  "option": null
}

Description

This call tracks the fabric cuts (CAD lengths) of fabrics. Cut lengths for all shell, lining, and a few specific options for each garment need to be entered into the Trinity system.

HTTP Request

POST https://api.trinity-apparel.com/v1/fabric_cuts

Query Parameters

Parameter Default Description
id N/A Garment ID
fabric_id N/A Fabric ID. Integer not String
length_m N/A Fabric length in centimeters
width_m N/A Fabric width in centimeters
is_cut false Boolean. Denotes if fabric has been cut

Other

Responses

Response Code Description
201 Fabric cut entry was created
403 Error: Not Authorized - You're not a factory or the garment isn't from your factory
409 Error: Unable to create a fabric cut. Error message is provided

Get All Fabric Cuts

curl "https://api.trinity-apparel.com/v1/fabric_cuts"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 546530,
        "is_cut": false,
        "created_at": "2019-11-07T03:23:42.000Z",
        "length": 475,
        "actual_length": 470,
        "width": 1,
        "garment": {
            "id": 1015730,
            "title": "IDUK-1015730",
            "created_at": "2019-05-28T12:25:00.000Z",
            "garment_type": "CCP"
        },
        "fabric": {
            "id": 61257,
            "description": "Char Blue Wine Plaid",
            "trinity_fabric_number": "K4-3861257",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/K4-3861257",
            "has_image": true
        },
        "option": null
    },
    {
        "id": 546531,
        "is_cut": false,
        "created_at": "2019-11-07T03:23:42.000Z",
        "length": 165,
        "actual_length": 160,
        "width": 146,
        "garment": {
            "id": 1015730,
            "title": "IDUK-1015730",
            "created_at": "2019-05-28T12:25:00.000Z",
            "garment_type": "CCP"
        },
        "fabric": {
            "id": 40512,
            "description": "Burgundy Camouflage",
            "trinity_fabric_number": "L2-3540512",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/L2-3540512",
            "has_image": true
        },
        "option": {
            "id": 229,
            "name": "lining_fabric_num",
            "description": "Lining Fabric #"
        }
    },
    {
        "id": 546307,
        "is_cut": false,
        "created_at": "2019-11-07T01:58:49.000Z",
        "length": 455,
        "actual_length": 450,
        "width": 148,
        "garment": {
            "id": 1068322,
            "title": "ID-1068322",
            "created_at": "2019-10-04T00:14:08.000Z",
            "garment_type": "CCVP"
        },
        "fabric": {
            "id": 42243,
            "description": "Black Pinstripe",
            "trinity_fabric_number": "LA-3542243",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/LA-3542243",
            "has_image": true
        },
        "option": null
    },
    {
        "id": 546308,
        "is_cut": false,
        "created_at": "2019-11-07T01:58:49.000Z",
        "length": 390,
        "actual_length": 385,
        "width": 136,
        "garment": {
            "id": 1068322,
            "title": "ID-1068322",
            "created_at": "2019-10-04T00:14:08.000Z",
            "garment_type": "CCVP"
        },
        "fabric": {
            "id": 27476,
            "description": "Black Skulls",
            "trinity_fabric_number": "L6-3127476",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/L6-3127476",
            "has_image": true
        },
        "option": {
            "id": 229,
            "name": "lining_fabric_num",
            "description": "Lining Fabric #"
        }
    },
    ...
]

Returns an array of fabric cuts.

Click here for details on the response objects.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabric_cuts

Query Parameters

Parameter Default Description
manufacturer_id N/A Manufacturer ID for the factory
garment_id N/A One or more garment ids. Use array style syntax garment_id[] for multiple.
fabric_id N/A One or more fabric ids. Use array style syntax fabric_id[] for multiple.
is_cut false Filter by if the fabric has been cut
order_status_code Read more Optional. Default is BLUE_PENCIL and CUTTING. Filter using a single order status

A manufacturer_id must be provided.

NOTE: If order status is not provided, we filter by these statuses: STATUS_BLUE_PENCIL and STATUS_CUTTING

Other

Examples

Fabric cuts for one factory

GET https://api.trinity-apparel.com/v1/fabric_cuts?manufacturer_id=2

Returns all fabric cuts from manufacturer 2 that are from garments in CUTTING OR BLUE PENCIL status..

Fabric cuts for 3 specific garments

GET https://api.trinity-apparel.com/v1/fabric_cuts?garment_id[]=1001234&garment_id[]=1002345&garment_id[]=1003456

Returns all fabric cuts that came for 3 specific garments.

Fabric cuts for a specific fabric that are in an order status

GET https://api.trinity-apparel.com/v1/fabric_cuts?fabric_id=50505&order_status_code=READY

Returns all fabric cuts for garments in Ready (code = READ) status that use a particular fabric.

Update Fabric Cut

curl -X POST "https://api.trinity-apparel.com/v1/fabric_cuts/:id"
  -H "Authorization Bearer: swaledale"

The above command returns a 202 Accepted and no JSON output when it is successful.

Description

This call updates a fabric cut. Users can only modify the is_cut boolean and set it to true or false.

Rules

The fabric cut may only be modified while the garment is in a production status: BLUE_PENCIL, CUTTING, READY, or PRODUCTION.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabric_cuts/:id

Query Parameters

Parameter Default Description
id N/A id number for the cut

Other

Responses

Response Code Description
201 Fabric cut was successfully changed
403 Not Authorized - You're not a factory or the cut isn't from your factory
409 Unable to update the fabric cut. Reason provided in JSON

Set Order Status

curl -X POST "https://api.trinity-apparel.com/v1/garments/:id/order_statuses/:order_status"
  -H "Authorization Bearer: swaledale"

The above command returns a 201 Created and no JSON output when it is successful.

Description

This call updates the order status of a garment and puts an entry in garment history to note when the change was made.

Our customers, partners, and staff can see the order status for each garment. It helps us set expecations for when we can make delivery, so it is important to keep things up to date.

Rules

Trinity enforces strict validation rules so that garments can only move to a few order statuses from any given status. Here are the valid transitions for each status:

Starting Status Valid Destination Status
Incomplete CMT Fabric Hold, Fabric Hold, Ready, Cancelled
CMT Fabric Hold Fabric Hold, Ready, Cancelled
Fabric Hold Ready, Cancelled
Ready Blue Pencil, Cutting, Production, Cancelled
Blue Pencil Cutting, Production, Production Complete, Cancelled
Cutting Production, Production Complete, Cancelled
Production Production Complete, International Transit, Cancelled
Production Complete International Transit, Direct Ship, Cancelled
International Transit Final Inspection, Shipment Processing, Direct Ship, Cancelled
Final Inspection Shipment Processing, Delivery, Direct Ship, Cancelled
Shipment Processing Delivery, Direct Ship, Cancelled
Delivery Shipment Processing, Cancelled
Direct Ship Production Complete, Cancelled
Cancelled

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/order_statuses/:order_status

Query Parameters

Parameter Default Description
order_status N/A Can be an id number or a code. Click here for more info

Other

Responses

Response Code Description
201 Garment Order status was successfully changed
403 Not Authorized - You're not a factory or the garment isn't from your factory
409 Unable to move to a different status. Reason provided in JSON

Set Delay Status

curl -X POST "https://api.trinity-apparel.com/v1/garments/:id/delay_statuses/:delay_status"
  -H "Authorization Bearer: swaledale"

The above command returns a 201 Created and no JSON output when it is successful.

Description

This call updates the delay status of a garment and puts an entry in garment history to note when the change was made.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/delay_statuses/:delay_status

Query Parameters

Parameter Default Description
delay_status N/A Can be an id number or a code. Click here for more info
notes N/A Optional param to provide a reason for for updating the delay status

Other

Responses

Response Code Description
201 Garment Order status was successfully changed
403 Not Authorized - You're not a factory or the garment isn't from your factory
409 Unable to move to a different status. Reason provided in JSON

Update Inventory

curl -X POST "https://api.trinity-apparel.com/v1/sku/update_inventory"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 9678,
  "stock_available": "15.0",
  "stock_on_hand": "15.0",
  "created_at": "2021-02-24T21:44:55.000Z",
  "updated_at": "2021-02-24T21:44:55.000Z",
  "sku": {
    "id": 44543,
    "sku": "FAB-0000003",
    "supplier_number": "74363/3",
    "collection": "Reda Luxury Jacketing Super 130's V18072",
    "name": "Navy Graphite Plaid",
    "description": null,
    "created_at": "2018-04-16T11:59:31.000Z",
    "updated_at": "2021-01-18T23:28:57.000Z"
  }
}

Description

This call updates the stock amount of a Sku.

We use the stock amount of Trinity-owned fabrics to determine their availibity to order a garment made from this fabric.

Rules

Both stock and supplier_number parameters are required and an error will be returned if either are missing.

Also, a Sku must already exist with the provided supplier number. If the Sku does not exist, an error will be returned and you will either have to provide the correct supplier number or contact Trinity staff so a Sku can be created.

HTTP Request

GET https://api.trinity-apparel.com/v1/sku/update_inventory

Query Parameters

Parameter Default Description
supplier_number N/A The supplier number of the fabric you wish to update the inventory of
stock N/A The current total amount of stock you have of the fabric (must be numeric)

Other

Responses

Response Code Description
202 Inventory was successfully changed
403 Not Authorized - You're not a factory
409 Unable to update inventory. Reason provided in JSON

Shipping API

The Shipping API allows a factory to receive raw materials (fabrics) and add a garment to a shipment.

This includes:

Create Shipment

curl -X POST "https://api.trinity-apparel.com/v1/shipments"
  -H "Authorization Bearer: swaledale"

The above command returns a 201 Created and returns a JSON structured like this:

{
    "id": 371421,
    "description": "US Shirts - December 13 #8 from iD Shirts",
    "status": "transit",
    "method": "Worldwide Express",
    "carrier": "FedEx",
    "tracking_number": null,
    "create_date": "2019-12-13T07:05:37.000Z",
    "ship_date": null,
    "receive_date": null,
    "login_id": 1578,
    "source": {
        "id": 1943,
        "description": "Beijing iDesign Garments",
        "street1": "No. 8, Fuqian Street",
        "street2": "Beixiaoying County, Shunyi District",
        "street3": null,
        "city": null,
        "state": "Beijing",
        "zip": "101300",
        "country": "People's Rep. of China",
        "phone": "Tel:  +86 (0)10 60400433"
    },
    "destination": {
        "id": 1,
        "description": "Trinity USA",
        "street1": "227 Marketridge Dr",
        "street2": null,
        "street3": null,
        "city": "Ridgeland",
        "state": "MS",
        "zip": "39157",
        "country": "USA",
        "phone": "601-713-2628"
    },
    "shipment_items": [
        {
            "id": 1855007,
            "item_id": 941358,
            "created_at": "2019-07-09T10:18:07.000Z"
        },
        ...
    ]
}

Description

This call creates a shipment then adds every garment id that was provided to the shipment. A shipment is just like a packing list.

It also creates a tracking box and tracking box items, which our distribution centers use to track and receive garments from a manufacturer.

Rules

All items in a shipment must be going to the same destination. If any garment is going to another location the whole shipment fails to be created. Although the first check should cover this case, all garments in a shipment should be of the same shipping class.

Same rules apply to manufacturers. If any item is from a different manufacturer, the shipment will fail to be created.

HTTP Request

POST https://api.trinity-apparel.com/v1/shipments

Query Parameters

Parameter Default Description
garment_id[] N/A An array of garment ids. All garments must be included when the shipment is created
tracking_number null Optional. The tracking number for the shipping carrier (E.g., FedEx, DHL, etc)

Other

Responses

Response Code Description
201 Garment Order status was successfully changed
403 Not Authorized - You're not a factory or the garment isn't from your factory
409 Unable to move to a different status. Reason provided in JSON

Complete Shipment

curl -X POST "https://api.trinity-apparel.com/v1/shipments/:id/complete"
  -H "Authorization Bearer: swaledale"

The above command returns a 201 Created and returns a JSON structured like this:

{
    "id": 507121,
    "description": "US Suits - November 17 #2 from T2iD MTM",
    "status": "transit",
    "method": "Worldwide Express",
    "carrier": "UPS",
    "tracking_number": "1Z9F23146639469257",
    "receive_date": null,
    "create_date": "2023-11-17T21:36:56.000Z",
    "ship_date": "2023-11-17T21:37:38.000Z",
    "shipment_type": "garment order",
    "login_id": 1862,
    "supplier": null,
    "source": {
        "id": 2343,
        "contact_name": "Verawati Roma Uli",
        "description": "PT. Trisco",
        "street1": "Jl. Raya Kopo - Soreang",
        "street2": "KM. 11.5 Katapang - Soreang",
        "street3": null,
        "city": "Bandung",
        "state": "Jawa Barat",
        "zip": "40971",
        "country": "Indonesia",
        "phone": "+62-22 589 7185"
    },
    "destination": {
        "id": 1,
        "contact_name": "Trinity Apparel Group, LLC",
        "description": "Trinity USA",
        "street1": "227 Marketridge Dr",
        "street2": null,
        "street3": null,
        "city": "Ridgeland",
        "state": "MS",
        "zip": "39157",
        "country": "USA",
        "phone": "601-713-2628"
    },
    "shipment_items": [
        {
            "id": 2747629,
            "item_id": 1520852,
            "created_at": "2023-11-17T21:36:56.000Z"
        },
        {
            "id": 2747630,
            "item_id": 1520868,
            "created_at": "2023-11-17T21:36:56.000Z"
        }
    ],
    "fabric_orders": []
}

Description

This call finalizes a shipment and moves the status of the shipment to 'transit'. If the tracking number for the shipment was not known at the time the shipment was created, it can be updated with the optional tracking number parameter. This call will also move all garments contained in the shipment to the status of 'International Transit'.

Rules

A shipment ID must be provided and the status of that shipment must be Pending. If the shipment is not pending, the shipment will fail to be completed.

As shipment can only be completed by the manufacturer who created the shipment.

Again, we check to ensure all garments contained in the shipment are of the same shipping class, either Direct or Garment Order. If any garment is of a different shipping class, the shipment will fail to be completed.

HTTP Request

POST https://api.trinity-apparel.com/v1/shipments/:id/complete

Query Parameters

Parameter Default Description
shipment_id N/A The id of the shipment you are wishing to complete
tracking_number null Optional. The tracking number for the shipping carrier (E.g., FedEx, DHL, etc)

Other

Responses

Response Code Description
201 Shipment successfully completed
403 Not Authorized - You're not a factory or the garment isn't from your factory
409 Unable to move to a different status. Reason provided in JSON

Get Shipment Detail

curl -X GET "https://api.trinity-apparel.com/v1/shipments/:id"
  -H "Authorization Bearer: swaledale"

The above command returns a JSON structured like this:

{
    "id": 351907,
    "description": "UK Shirts - May 22 #6 from iD Shirts",
    "status": "received",
    "method": "Worldwide Express",
    "carrier": "FedEx",
    "tracking_number": "485590026995",
    "create_date": "2019-05-22T06:58:58.000Z",
    "ship_date": "2019-05-22T02:52:14.000Z",
    "shipment_type": "bulk",
    "receive_date": "2019-05-29T08:12:59.000Z",
    "login_id": 1026,
    "supplier": {
        "id": 48,
        "code": "GI",
        "name": "Giovani",
        "city": "",
        "state": null,
        "country": "Hong Kong"
    },
    "source": {
        "id": 1943,
        "description": "Beijing iDesign Garments",
        "street1": "No. 8, Fuqian Street",
        "street2": "Beixiaoying County, Shunyi District",
        "street3": null,
        "city": null,
        "state": "Beijing",
        "zip": "101300",
        "country": "People's Rep. of China",
        "phone": "Tel:  +86 (0)10 60400433"
    },
    "destination": {
        "id": 1222,
        "description": "Trinity UK Shipping",
        "street1": "8 George St.",
        "street2": null,
        "street3": null,
        "city": "Alderley Edge",
        "state": null,
        "zip": "SK9 7EJ",
        "country": "U.K.",
        "phone": null
    },
    "shipment_items": [
        {
            "id": 1819962,
            "item_id": 996625,
            "created_at": "2019-05-22T06:58:58.000Z"
        },
        {
            "id": 1819965,
            "item_id": 996626,
            "created_at": "2019-05-22T06:58:58.000Z"
        },
        {
            "id": 1819963,
            "item_id": 996627,
            "created_at": "2019-05-22T06:58:58.000Z"
        },
        {
            "id": 1819969,
            "item_id": 996630,
            "created_at": "2019-05-22T06:58:58.000Z"
        },
        ...
    ],
    "fabric_orders": [
        {
            "id": 397950,
            "fabric_id": 72898,
            "garment_id": 1143878,
            "length": "1.125",
            "address_id": 12310,
            "extra_fabric": false,
            "fulfillment_failure": false,
            "shipment_id": 385700,
            "reason": "null",
            "created_at": "2020-06-04T00:00:00.000Z",
            "status": "rejected",
            "trinity_fabric_number": "N6-4072898",
            "supplier_fabric_number": "JT 82099-82",
            "description": "White Solid Linen",
            "image": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898",
            "material_type": "Fabric"
        }
    ]
}

Description

Returns detail on a shipment, which includes the tracking number and destination. It also includes a full list of shipment items.

Types of Shipments

Fabric Order

Fabric Order shipments occur when fabrics shipped from a supplier to a factory. Fabric Orders and Supplier are only returned for fabric order shipments. There will not be any shipment items in a fabric order, since shipment items are a listing of garments in the shipment and this is only for raw materials.

Shipment Type

Shipments are either direct ship or bulk. Direct ship means the shipment is going directly to a customer. Bulk means the shipment is going to a distribution center.

Garment Order

Garment order shipments are sent from a factory to a distribution center. The shipments from our factory to HQ are bulk and are typically part of 10-20 cartons sent each day. Each box is tracked as an individual shipment. However, direct shipments and shipments to the UK or CA distribution centers are smaller in volume and typically are a single box.

Dealer Order

Dealer order shipments are from a distribution center to the final destination, the dealer's shipping address. They are typically small and are almost always from the HQ distribution center in Ridgeland, MS to another address in the USA.

HTTP Request

GET https://api.trinity-apparel.com/v1/shipments/:id

Query Parameters

Parameter Default Description
id N/A Lookup id for the shipment

Other

Receive Shipment

curl -X POST "https://api.trinity-apparel.com/v1/shipments/:id/receive"
  -H "Authorization Bearer: swaledale"

The above command returns a JSON structured like this:

{
  "id": 385700,
  "description": "Testing Shipping Fabric Orders",
  "status": "received",
  "method": "Ground",
  "carrier": null,
  "tracking_number": null,
  "create_date": "2020-06-04T00:00:00.000Z",
  "ship_date": "2020-06-04T00:00:00.000Z",
  "receive_date": "2020-06-09T22:14:58.000Z"
}

Description

Sets the status of a shipment to recieved. The shipment must be in transit status.

Note: Only fabric order shipments can be received at this time.

HTTP Request

POST https://api.trinity-apparel.com/v1/shipments/:id/receive

Query Parameters

Parameter Default Description
id N/A Lookup id for the shipment

Other

Get Fabric Shipments

curl -X GET "https://api.trinity-apparel.com/v1/fabric_shipments"
  -H "Authorization Bearer: swaledale"

The above command returns a JSON structured like this:

[
  {
    "id": 388757,
    "description": "Fabric Orders 07/16/20 from Giovani to Trinity USA",
    "status": "received",
    "method": null,
    "carrier": "DHL",
    "tracking_number": "8341286236",
    "create_date": "2020-07-16T04:31:51.000Z",
    "ship_date": "2020-07-16T04:33:15.000Z",
    "receive_date": "2020-07-23T06:26:27.000Z",
    "login_id": 2,
    "packing_list_url": "https://workflow.trinity-apparel.com/supplier/shipment_packing_list.php?shipment_id=388757&token=eyJhbGciOiJSUzI1NiJ9",
    "invoice_url": "https://workflow.trinity-apparel.com/supplier/shipment_invoice.php?shipment_id=388757&token=eyJhbGciOiJSUzI1NiJ9",
    "supplier": {
      "id": 48,
      "code": "GI",
      "name": "Giovani",
      "city": "Samphanthawong",
      "state": "Bangkok",
      "country": "Thailand"
    },
    "source": {
      "id": 14431,
      "description": "Warehouse Address",
      "street1": "161 Vanich 1 Road (Sampheng)",
      "street2": "Chakrawat",
      "street3": null,
      "city": "Samphanthawong",
      "state": "Bangkok",
      "zip": "10100",
      "country": "Thailand",
      "phone": "(66) 02 2229190"
    },
    "destination": {
      "id": 2343,
      "description": "PT. Trisco",
      "street1": "Jl. Raya Kopo - Soreang",
      "street2": "KM. 11.5 Katapang - Soreang",
      "street3": null,
      "city": "Bandung",
      "state": "Jawa Barat",
      "zip": "40971",
      "country": "Indonesia",
      "phone": "+62-22 589 7185"
    },
    "shipment_items": [],
    "fabric_orders": [
      {
        "id": 400569,
        "fabric_id": 84544,
        "garment_id": 1152408,
        "length": "2.375",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 388757,
        "reason": null,
        "created_at": "2020-07-15T19:41:29.000Z",
        "status": "accepted",
        "trinity_fabric_number": "TT-4184544",
        "supplier_fabric_number": "T547",
        "description": "Blue Shepard Twill Check",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/TT-4184544",
        "material_type": "Fabric"
      },
      {
        "id": 400570,
        "fabric_id": 84544,
        "garment_id": 1152409,
        "length": "2.375",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 388757,
        "reason": null,
        "created_at": "2020-07-15T19:41:29.000Z",
        "status": "accepted",
        "trinity_fabric_number": "TT-4184544",
        "supplier_fabric_number": "T547",
        "description": "Blue Shepard Twill Check",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/TT-4184544",
        "material_type": "Fabric"
      },
      {
        "id": 400571,
        "fabric_id": 84544,
        "garment_id": 1152410,
        "length": "2.375",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 388757,
        "reason": null,
        "created_at": "2020-07-15T19:41:29.000Z",
        "status": "accepted",
        "trinity_fabric_number": "TT-4184544",
        "supplier_fabric_number": "T547",
        "description": "Blue Shepard Twill Check",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/TT-4184544",
        "material_type": "Fabric"
      },
      {
        "id": 400572,
        "fabric_id": 84544,
        "garment_id": 1152411,
        "length": "2.375",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 388757,
        "reason": null,
        "created_at": "2020-07-15T19:41:29.000Z",
        "status": "accepted",
        "trinity_fabric_number": "TT-4184544",
        "supplier_fabric_number": "T547",
        "description": "Blue Shepard Twill Check",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/TT-4184544",
        "material_type": "Fabric"
      }
    ]
  },
  {
    "id": 389426,
    "description": "Fabric Orders 07/29/20 from RDL to PT. Trisco",
    "status": "received",
    "method": null,
    "carrier": "DHL",
    "tracking_number": "1943555036",
    "create_date": "2020-07-29T03:05:04.000Z",
    "ship_date": "2020-07-29T03:12:06.000Z",
    "receive_date": "2020-08-04T06:21:21.000Z",
    "login_id": 2,
    "packing_list_url": "https://workflow.trinity-apparel.com/supplier/shipment_packing_list.php?shipment_id=389426&token=eyJhbGciOiJSUzI1NiJ9",
    "invoice_url": "https://workflow.trinity-apparel.com/supplier/shipment_invoice.php?shipment_id=389426&token=eyJhbGciOiJSUzI1NiJ9",
    "supplier": {
      "id": 19,
      "code": "RD",
      "name": "RDL",
      "city": "Tsim Sha Tsui",
      "state": "Kowloon",
      "country": "Hong Kong"
    },
    "source": {
      "id": 14413,
      "description": "Warehouse Address",
      "street1": "4/F Windsor Mansion",
      "street2": "29-31 Chatham Road",
      "street3": null,
      "city": "Tsim Sha Tsui",
      "state": "Kowloon",
      "zip": null,
      "country": "Hong Kong",
      "phone": "+852 2368 8060"
    },
    "destination": {
      "id": 2343,
      "description": "PT. Trisco",
      "street1": "Jl. Raya Kopo - Soreang",
      "street2": "KM. 11.5 Katapang - Soreang",
      "street3": null,
      "city": "Bandung",
      "state": "Jawa Barat",
      "zip": "40971",
      "country": "Indonesia",
      "phone": "+62-22 589 7185"
    },
    "shipment_items": [],
    "fabric_orders": [
      {
        "id": 401508,
        "fabric_id": 83661,
        "garment_id": 1154658,
        "length": "4.5",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T07:42:53.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183661",
        "supplier_fabric_number": "28415-180",
        "description": "Grey Purple Stripe",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183661",
        "material_type": "Fabric"
      },
      {
        "id": 401531,
        "fabric_id": 83679,
        "garment_id": 1154867,
        "length": "3.5",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T11:59:46.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183679",
        "supplier_fabric_number": "25919-180",
        "description": "Grey Red Windowpane",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183679",
        "material_type": "Fabric"
      },
      {
        "id": 401534,
        "fabric_id": 83666,
        "garment_id": 1154675,
        "length": "5.75",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T12:05:09.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183666",
        "supplier_fabric_number": "28341-180",
        "description": "Grey Blue Stripe",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183666",
        "material_type": "Fabric"
      },
      {
        "id": 401678,
        "fabric_id": 83638,
        "garment_id": 1154954,
        "length": "3.75",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T17:02:10.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183638",
        "supplier_fabric_number": "28425-180",
        "description": "Grey Blue Windowpane",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183638",
        "material_type": "Fabric"
      },
      {
        "id": 401679,
        "fabric_id": 83740,
        "garment_id": 1154968,
        "length": "1.625",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T17:02:10.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183740",
        "supplier_fabric_number": "25928-180",
        "description": "Navy Solid",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183740",
        "material_type": "Fabric"
      },
      {
        "id": 401680,
        "fabric_id": 83744,
        "garment_id": 1154949,
        "length": "4.75",
        "address_id": 2343,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": 389426,
        "reason": null,
        "created_at": "2020-07-28T17:03:35.000Z",
        "status": "accepted",
        "trinity_fabric_number": "E3-4183744",
        "supplier_fabric_number": "28381-180",
        "description": "Burgundy Solid",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/E3-4183744",
        "material_type": "Fabric"
      }
    ]
  }
]

Description

Returns all fabric shipments (shipments which contain fabric orders) for a manufacturer.

Valid Statuses

Status Description
pending Shipment has been created, but hasn't been shipped yet
transit Shipment is currently in route to destination
received Shipment has been received by factory

HTTP Request

GET https://api.trinity-apparel.com/v1/fabric_shipments

Query Parameters

Parameter Default Description
status N/A Only see fabric shipments in a certain status

Other

Get All Fabric Orders

curl "https://api.trinity-apparel.com/v1/garments/:id/fabric_orders"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

[
    {
        "id": 320723,
        "fabric_id": 29888,
        "garment_id": 1100503,
        "length": "3.75",
        "address_id": 1943,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": null,
        "reason": null,
        "created_at": "2019-12-17T17:35:11.000Z",
        "status": "received",
        "trinity_fabric_number": "L6-3129888",
        "supplier_fabric_number": "360072",
        "description": "Antique Golfers",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/L6-3129888",
        "material_type": "Fabric",
        "fabric": {
            "id": 29888,
            "active": true,
            "description": "Antique Golfers",
            "supplier_fabric_number": "360072",
            "trinity_fabric_number": "L6-3129888",
            "url": "https://s7d4.scene7.com/is/image/trinityapparel/L6-3129888",
            "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=L6-3129888&res=300",
            "pattern_id": null,
            "weave_id": null,
            "price_tier": 4,
            "discount": null,
            "has_image": true,
            "favorite_id": null,
            "fabric_type": null,
            "fabric_garment_type": 0,
            "trim_garment_type": 759,
            "material_type": "Fabric"
        },
        "address": {
            "id": 1943,
            "description": "Beijing iDesign Garments",
            "street1": "No. 8, Fuqian Street",
            "street2": "Beixiaoying County, Shunyi District",
            "street3": null,
            "city": null,
            "state": "Beijing",
            "zip": "101300",
            "country": "People's Rep. of China",
            "phone": "Tel:  +86 (0)10 60400433"
        },
        "garment": {
            "id": 1100503,
            "title": "ID-1100503",
            "order_id": 505484,
            "copied_garment_id": null,
            "price": "832.0",
            "option_cost": "100.0",
            "garment_type": "CCP",
            "created_at": "2019-12-17T17:35:11.000Z",
            "updated_at": null,
            "order_status_id": 9,
            "delay_status_id": 1,
            "fabric_url": null
        },
        "shipment": null
    },
    {
        "id": 320724,
        "fabric_id": 58067,
        "garment_id": 1100503,
        "length": "4.5",
        "address_id": 1943,
        "extra_fabric": false,
        "fulfillment_failure": false,
        "shipment_id": null,
        "reason": null,
        "created_at": "2019-12-17T17:35:11.000Z",
        "status": "accepted",
        "trinity_fabric_number": "Y4-3858067",
        "supplier_fabric_number": "290015",
        "description": "Slate Puppytooth",
        "image": "https://s7d4.scene7.com/is/image/trinityapparel/Y4-3858067",
        "material_type": "Fabric",
        "fabric": {
            ...
        },
        "address": {
            ...
        },
        "garment": {
            ...
        },
        "shipment": null
    }
]

Description

Returns an array of fabric orders for a specific garment. Each fabric order includes details on the fabric, address, garment, and shipment attached to it.

Note: Almost all fabric orders are generated at checkout. We rarely add them manually to the system. Sometimes a fabric order will be cancelled (typically when the fabric is out of stock) and a new one will be made when the order is edited and a new fabric is chosen.

HTTP Request

GET https://api.trinity-apparel.com/v1/garments/:id/fabric_orders

Query Parameters

Parameter Default Description
id N/A The specific garment you want to get fabric orders for

Other

Get Fabric Order

curl "https://api.trinity-apparel.com/v1/fabric_orders/:id"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 397950,
  "fabric_id": 72898,
  "garment_id": 1143878,
  "length": "1.125",
  "address_id": 12310,
  "extra_fabric": false,
  "fulfillment_failure": false,
  "shipment_id": 385700,
  "reason": "null",
  "created_at": "2020-06-04T00:00:00.000Z",
  "status": "transit",
  "trinity_fabric_number": "N6-4072898",
  "supplier_fabric_number": "JT 82099-82",
  "description": "White Solid Linen",
  "image": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898",
  "fabric_composition": "100% Bamboo",
  "fabric": {
    "id": 72898,
    "active": true,
    "description": "White Solid Linen",
    "supplier_fabric_number": "JT 82099-82",
    "trinity_fabric_number": "N6-4072898",
    "url": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898",
    "swatch_url": "https://s7d4.scene7.com/ir/render/trinityapparelrender/SwatchWorkflo?obj=Swatch/Fabric&src=N6-4072898&res=300",
    "pattern_id": 1,
    "weave_id": null,
    "price_tier": 2,
    "discount": null,
    "has_image": true,
    "favorite_id": null,
    "fabric_type": null,
    "fabric_garment_type": 8,
    "trim_garment_type": 0,
    "material_type": "Fabric"
  },
  "address": {
    "id": 12310,
    "description": "Tyler Jones",
    "street1": "1102 Knox Cove",
    "street2": null,
    "street3": null,
    "city": "Madison",
    "state": "NJ",
    "zip": "59876",
    "country": "USA",
    "phone": "(555)111-2345"
  },
  "garment": {
    "id": 1143878,
    "title": "IDUK-1143878",
    "order_id": 526328,
    "copied_garment_id": 1046085,
    "price": "53.0",
    "option_cost": "0.0",
    "garment_type": "CSHT",
    "created_at": "2020-06-03T00:40:43.000Z",
    "updated_at": "2020-06-03T00:40:43.000Z",
    "order_status_id": 3,
    "delay_status_id": 4,
    "fabric_url": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898"
  },
  "shipment": {
    "id": 385700,
    "description": "Testing Shipping Fabric Orders",
    "status": "received",
    "method": "Ground",
    "carrier": null,
    "tracking_number": null,
    "create_date": "2020-06-04T00:00:00.000Z",
    "ship_date": "2020-06-04T00:00:00.000Z",
    "receive_date": "2020-06-09T22:14:58.000Z"
  }
}

Description

Returns details of a fabric order, including details on the fabric, address, garment, and shipment attached to it.

Note: Almost all fabric orders are generated at checkout. We rarely add them manually to the system. Sometimes a fabric order will be cancelled (typically when the fabric is out of stock) and a new one will be made when the order is edited and a new fabric is chosen.

HTTP Request

GET https://api.trinity-apparel.com/v1/fabric_orders/:id

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to see

Other

Receive Fabric Order

curl -X POST "https://api.trinity-apparel.com/v1/fabric_orders/:id/receive"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 397950,
  "fabric_id": 72898,
  "garment_id": 1143878,
  "length": "1.125",
  "address_id": 12310,
  "extra_fabric": false,
  "fulfillment_failure": false,
  "shipment_id": 385700,
  "reason": "null",
  "created_at": "2020-06-04T00:00:00.000Z",
  "status": "received",
  "trinity_fabric_number": "N6-4072898",
  "supplier_fabric_number": "JT 82099-82",
  "description": "White Solid Linen",
  "image": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898"
}

Description

This updates the status of a fabric order to be received and returns the fabric order. The fabric must be in the transit status before it can be received.

HTTP Request

POST https://api.trinity-apparel.com/v1/fabric_orders/:id/receive

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to receive

Other

Accept Fabric Order

curl -X POST "https://api.trinity-apparel.com/v1/fabric_orders/:id/accept"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 397950,
  "fabric_id": 72898,
  "garment_id": 1143878,
  "length": "1.125",
  "address_id": 12310,
  "extra_fabric": false,
  "fulfillment_failure": false,
  "shipment_id": 385700,
  "reason": "null",
  "created_at": "2020-06-04T00:00:00.000Z",
  "status": "accepted",
  "trinity_fabric_number": "N6-4072898",
  "supplier_fabric_number": "JT 82099-82",
  "description": "White Solid Linen",
  "image": "https://s7d4.scene7.com/is/image/trinityapparel/N6-4072898"
}

Description

Once a fabric has been received and has passed your inspection process, use this API call to mark it as accepted and to confirm the length and width of the fabric you received. We use this information to ensure that our suppliers cut fabrics to the correct dimensions.

Fabric order must have a status of either transit or recieve to be accepted. This will create a Fabric Checkpoint, set the status of the fabric order to accepted, and also move the garment to the Ready order status (as long as all required fabrics have been received). If unsuccessful, it will return the error that was encountered. If successful, it will return the updated fabric order.

If the pattern is solid, you will only need to pass the cuttable_width, cuttable_length and fabric_type_code params. If the pattern is stripe or check, you will also need to include the fabric_type_width. If the pattern is check, you will also need fabric_type_length.

Detail

The allowed fabric type codes are:

Code Description
check Check 1 - Symmetric
check_asymmetric Check 2 - Asymmetric
solid Solid, Paisley or Other
stripe Stripe

HTTP Request

POST https://api.trinity-apparel.com/v1/fabric_orders/:id/accept

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to accept
cuttable_length N/A The cuttable length of the fabric
cuttable_width N/A The cuttable width of the fabric
fabric_type_code N/A The code for the fabric pattern (see above)
fabric_type_length N/A The length of the fabric pattern (only needed for check and check_asymmetric patterns)
fabric_type_width N/A The width of the fabric pattern (only needed for stripe, check and check_asymmetric patterns)

Other

Reject Fabric Order

curl -X POST "https://api.trinity-apparel.com/v1/fabric_orders/:id/reject"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "fabric_order": {
    "id": 397950,
    "status": "rejected",
    "garment_id": 1143878,
    "fabric_id": 72898,
    "address_id": 12310,
    "length": "1.125",
    "shipment_id": 385700,
    "login_id": 1710,
    "extra_fabric": false,
    "fulfillment_failure": false,
    "reason": "null",
    "created_at": "2020-06-04T00:00:00.000Z",
    "updated_at": "2020-06-09T21:37:47.000Z"
  },
  "new_fabric_order": {
    "id": 397968,
    "status": "pending",
    "fabric_id": 72898,
    "address_id": 12310,
    "garment_id": 1143878,
    "length": "1.125",
    "extra_fabric": true,
    "fulfillment_failure": false,
    "shipment_id": 385700,
    "login_id": 1578,
    "reason": "flawed",
    "created_at": null,
    "updated_at": null
  }
}

Description

WARNING This API call will automatically place a new fabric order with the vendor as long as the fabric is in stock.

Use this API call after you receive a fabric and the fabric fails your inspection process. You'll mark the reason it was rejected and we can usually automatically reorder it from the supplier.

Fabric orders must have a status of either transit or recieved to be rejected. This will move the garment into the correct delay status (typically no delay) and set the status of the fabric order to rejected. It will also create a new fabric order as long as the fabric is in stock and the reason isn't due to a fabric short. If either the fabric was short or out of stock, a fabric order will have to be placed manually.

If everything was successful, you will get back an updated copy of the current fabric order as well as the newly placed fabric order (same fabric but the length you specified). If there was an error, the error message will be returned. And if the new_fabric_order is null, that means a new order was unable to be placed automatically and will have to be done manually.

Detail

The allowed reason codes are:

Code Description
part Alteration Parts
short Fabric Short
mistake Factory Mistake
dirty Fabric Dirty
flawed Fabric Flawed
hole Fabric has Holes
warped Fabric is Warped
wrong Wrong Fabric

HTTP Request

POST https://api.trinity-apparel.com/v1/fabric_orders/:id/reject

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to reject
reason_code N/A The reason you are rejecting the fabric
length N/A The total yards needed when reordering (optional, only include when different from the cut you received). Default is length of the order that arrived

Other

Fabric Order Errors

curl -X POST "https://api.trinity-apparel.com/v1/fabric_orders/:id/errors"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id_fabric_errors": 397953,
  "position_x": 22,
  "position_y": 12,
  "length": 15.0,
  "width": 17.0,
  "id_fabric_checkpoint": 397951
}

Description

This is to set errors found on a fabric. In order to record errors, the fabric order must be received by the factory (status of received or accepted). This will create and return a Fabric Error record that will define the coordinates for the unusable spot on the fabric.

HTTP Request

POST https://api.trinity-apparel.com/v1/fabric_orders/:id/errors

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to set errors on
position_x N/A The X position of the error on the fabric
position_y N/A The Y position of the error on the fabric
length N/A The total length of the error spot on the fabric
width N/A The total width of the error spot on the fabric

Other

Accept CMT Fabric

curl -X POST "https://api.trinity-apparel.com/v1/garment_fabrics/:id/accept"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 302261,
  "create_date": "2020-11-11T18:53:42.000Z",
  "garment_fabric_id": 24932183,
  "fabric_id": 1,
  "cuttable_width": 120.0,
  "cuttable_length": 140.0,
  "fabric_type": "Solid, Paisley or Other",
  "fabric_type_length": null,
  "fabric_type_width": null,
  "option_id": null
}

Description

Once a CMT fabric has been received and has passed your inspection process, use this API call to mark it as accepted and to confirm the length and width of the fabric you received. We use this information to ensure that the CMT fabric was cut to the correct dimensions.

This will create a Fabric Checkpoint and also move the garment to the Ready order status (as long as all required fabrics have been received). If unsuccessful, it will return the error that was encountered. If successful, it will return the Fabric Checkpoint.

If the pattern is solid, you will only need to pass the cuttable_width, cuttable_length and fabric_type_code params. If the pattern is stripe or check, you will also need to include the fabric_type_width. If the pattern is check, you will also need fabric_type_length.

Detail

The allowed fabric type codes are:

Code Description
check Check 1 - Symmetric
check_asymmetric Check 2 - Asymmetric
solid Solid, Paisley or Other
stripe Stripe

HTTP Request

POST https://api.trinity-apparel.com/v1/garment_fabrics/:id/accept

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to accept
cuttable_length N/A The cuttable length of the fabric
cuttable_width N/A The cuttable width of the fabric
fabric_type_code N/A The code for the fabric pattern (see above)
fabric_type_length N/A The length of the fabric pattern (only needed for check and check_asymmetric patterns)
fabric_type_width N/A The width of the fabric pattern (only needed for stripe, check and check_asymmetric patterns)

Other

Reject CMT Fabric

curl -X POST "https://api.trinity-apparel.com/v1/garment_fabrics/:id/reject"
  -H "Authorization Bearer: swaledale"

The above command returns JSON structured like this:

{
  "id": 1176246,
  "title": "IDUK-1176246",
  "order_id": 542524,
  "copied_garment_id": null,
  "price": "184.0",
  "option_cost": "0.0",
  "garment_type": "CCP",
  "created_at": "2020-11-05T04:29:32.000Z",
  "updated_at": null,
  "order_status_id": 21,
  "delay_status_id": 4,
  "fabric_url": "https://s7d4.scene7.com/is/image/trinityapparel/CMT-70001",
  "order_status": {
    "code": "READY",
    "name": "Pending",
    "description": "Ready"
  },
  "delay_status": {
    "code": "OK",
    "description": "Not Delayed"
  },
  "dealer_order": {
    "id": 542524,
    "title": "DO-542524",
    "custom_order_number": "Adam Uniform",
    "garment_count": 1,
    "ship_type": "Ground",
    "ship_cost": "8.05",
    "subtotal": "184.0",
    "dealer_discount": "0.0",
    "total_discount": "55.2",
    "tax": "27.37",
    "grand_total": "164.22",
    "deposit_percentage": 100,
    "current_balance": "0.0",
    "measurement_units": "uscust",
    "payment_status": "paid",
    "ordered_at": "2020-11-05T05:01:29.000Z",
    "created_at": "2020-11-05T04:22:07.000Z",
    "invoiced_at": null
  }
}

Description

Use this API call after you receive a CMT fabric and the fabric fails your inspection process. You'll mark the reason it was rejected and this will move the garment into the correct delay status (typically no delay) and notify the Trinity team that the CMT fabric was rejected so they can reach out to the dealer.

If everything was successful, you will get the garment back with the updated order and delay status. If there was an error, the error message will be returned.

Detail

The allowed reason codes are:

Code Description
part Alteration Parts
short Fabric Short
mistake Factory Mistake
dirty Fabric Dirty
flawed Fabric Flawed
hole Fabric has Holes
warped Fabric is Warped
wrong Wrong Fabric

HTTP Request

POST https://api.trinity-apparel.com/v1/garment_fabrics/:id/reject

Query Parameters

Parameter Default Description
id N/A The specific fabric order you want to reject
reason_code N/A The reason you are rejecting the fabric

Other

Changelog

A history of changes to the Trinity Apparel API.

2025-04-22

2023-11-16

2022-12-05

2022-10-27

Several updates to Materials API:

2022-06-01

New API to create/update fabric matches for a fabric.

2021-04-22

New API created to change the delay status on a garment.

2021-04-02

A lot of changes to fabrics API. Read through the resources and related calls carefully as the data structure has changed for fabrics. The most notable change is that in_stock, restock_date, last_stock_edit_date, and readiness have been combined under a new attribute called factories as these statuses can be different depending on the factory being ordered from.

Also, a new ability to see a collection of your favorite fabrics has been added to the collection API. Simply pass favorites in place of :id.

2021-02-25

Added new API for manufacturers to update fabric inventory.

2020-11-11

Added the ability to Accept and Reject CMT fabrics. This process is almost identical to accepting and rejecting single-length fabrics, but does have a few minor differences that require a different API call.

2020-11-06

Fabric Cut API will no longer move a garment to cutting automatically. Garment will now require being moved to cutting manually.

2020-10-15

Added material_type to fabric order API.

2020-10-12

Added material_type to fabric API.

2020-09-28

Added special_instructions array to garment properties API.

2020-09-09

Added additional filtering on customer dashboard. Can now filter on if customers have or have not ordered certain garment types within a date range.

2020-09-01

On download_garments API call, the outgoing address now also provides the contact name.

2020-08-06

2020-07-23

Added missing params for accepting a fabric order and added explantion on when they need to be included.

2020-07-22

Added Fabric Composition to GET /fabric_orders/:id

2020-06-17

Manufacturers can now manage fabric orders and fabric shipments from suppliers using the new Shipments API:

2020-06-02

2020-05-28

2020-04-16

2020-04-10

2020-02-27

2020-01-20

# Documentation

- Added Changelog
- Added docs on [Order Metrics](#order-metrics) route
- Added docs on fabric usage in garment properties and factory shipping address

2020-01-14

2020-01-08

2020-01-03

Older Changes

Unfortunately, there is no more changelog history at this time.