Details

Test Connection
https://test-api.finerworks.com/v3/test_my_credentials
GET

Use this for your first test and make sure your credentials are linked to your FinerWorks account information.
Details

Production Status List
https://test-api.finerworks.com/v3/list_order_status_definitions
GET

Lists all available production status an order can have once it has completed. Use the id number for reference purposes since the descriptive value can be redundent or change wording in some cases.
Details

List File Selection
https://test-api.finerworks.com/v3/list_file_selection?guid={guid}
GET

Returns a list of currently selected files. The querystring paremeter guid is the mater key assigned to all files that are selected.
Details

Update App Details
https://test-api.finerworks.com/v3/update_app_details
PUT

Updates the details assigned to the app_key being used.
Details

Update User Profile
https://test-api.finerworks.com/v3/update_user
PUT

Updates various features of a users account which can be useful.
Details

Update Status
https://test-api.finerworks.com/v3/update_order
PUT

Updates an existing submission order's status (note this is different than the production status). You can change the submission status of an order with the api prior to it being placed in production. Once an order is in production you will need to contact our customer support team to make any further updates.
Details

Update Customer
https://test-api.finerworks.com/v3/update_customer
PUT

Updates an existing order's customer (shipping information).
Details

Update Virtual Inventory
https://test-api.finerworks.com/v3/update_virtual_inventory
PUT

Updates various features of a users account which can be useful.
Details

Update Image Files
https://test-api.finerworks.com/v3/update_images
PUT

Updates a list of image files based on their unique id. Note if the image is assigned to the inventory library, this will also remove any virtual inventory products assigned to those images.
Details

Update File Selection
https://test-api.finerworks.com/v3/update_file_selection
PUT

Updates a list of a users current selected image files based on the selection key.
Details

Get User Profile
https://test-api.finerworks.com/v3/get_user?account_key={account_key}
GET

Must be authorized to use this endpoint.
Details

Submit Orders V2
https://test-api.finerworks.com/v3/submit_orders_v2
POST

Submits a list of new orders (up to 50 at a time) which includes customer details (sender and recipient) as well as line item details and optional display fields for the packing slip. Once an order is successfully submitted it will return a confirmation (order reference id) and place the order into an accepted status and ultimately in our production que.
Details

Create Note
https://test-api.finerworks.com/v3/submit_note
POST

Adds a note an order's log. Notes are for back reference purposes only and are NOT used for outside communication instructions to the production department or customer service.
Details

Get Order Status
https://test-api.finerworks.com/v3/fetch_order_status
POST

Retrieves an order's current "production" status. If an order is not found, no status will be returned.
Details

Shipping Options Multiple
https://test-api.finerworks.com/v3/list_shipping_options_multiple
POST

Submit a list of orders to get a list of available shipping options with the required shipping_code needed when submitting an order for each order. This endpoint should be requested under the following conditions. Any changes to the recipient of an order, a product is added or deleted from an order, the quantity of the any product changes.
Details

Address Validation
https://test-api.finerworks.com/v3/validate_recipient_address
POST

Can be used to validate and test an address such as an order's recipient.
Details

Get Price List
https://test-api.finerworks.com/v3/get_prices
POST

Returns a list of prices and their breakdown based on a list of product codes or virtual inventory skus. Request as few as 1 or as many as 50 in the body of the request.
Details

Product Details
https://test-api.finerworks.com/v3/get_product_details
POST

Request details and pricing (up to 25 skus at a time) based on sku and quantity. Additional response parameters may be added in the future as requested.
Details

List Image Files
https://test-api.finerworks.com/v3/list_images
POST

Provides a list of image files you have uploaded and any virtual inventory items assigned to them.
Details

Add Images Files
https://test-api.finerworks.com/v3/add_images
POST

Allows the user to add images to a library.
Details

List Virtual Inventory
https://test-api.finerworks.com/v3/list_virtual_inventory
POST

Provides a list of a user's virtual inventory (products) stored in their account.
Details

List Event Logs
https://test-api.finerworks.com/v3/list_event_logs
POST

Provides a list of event logs. Requires special permissions to be able to use this endpoint.
Details

Add Event Log
https://test-api.finerworks.com/v3/add_event
POST

Creates an event log entry that can be reviewed later for debugging purposes. This endpoint requires special permission to use.
Details

List Product Types
https://test-api.finerworks.com/v3/list_product_types
POST

Get a list of product types available at FinerWorks.
Details

List Media Types
https://test-api.finerworks.com/v3/list_media_types
POST

Get a list of media types available at FinerWorks.
Details

List Style Types
https://test-api.finerworks.com/v3/list_style_types
POST

Get a list of style types available at FinerWorks.
Details

List Frame Collections
https://test-api.finerworks.com/v3/list_collections
POST

List all available frame categories .
Details

Frame Details
https://test-api.finerworks.com/v3/frame_details
POST

List the prints currently setup in your inventory.
Details

Matting
https://test-api.finerworks.com/v3/list_mats
POST

Lists the available mats.
Details

Glazing
https://test-api.finerworks.com/v3/list_glazing
POST

Lists the avialable glazing / glass.
Details

Frame Builder
https://test-api.finerworks.com/v3/frame_builder
POST

This allows you to submit details to validate a framing option, get pricing and info as well as return base64 data you can use to display your frame package.
Details

Delete Virtual Inventory
https://test-api.finerworks.com/v3/delete_virtual_inventory
DELETE

Deletes virtual inventory products. Note that if any of these items are synced swith products on a 3rd party platform, those products will no longer be connected to FinerWorks.
Details

Delete Image Files
https://test-api.finerworks.com/v3/delete_images
DELETE

Deletes a list of image files based on their unique id. Note if the image is assigned to the inventory library, this will also remove any virtual inventory products assigned to those images.