Documentation

v1.0.0

Getting started

First things first, you’ll need to request an API key so we can understand what you want to build and ensure we can make it happen.

Authorization

Authorization with 99designs requires the following HTTP headers are forwarded on every request: Api-Key-Id and Api-Key-Secret. The values for theses headers are provided by 99designs.

curl -H "Api-Key-Id:xxx" -H "Api-Key-Secret:xxx" https://api.99designs.com/resources/v1/designers

Products

Your products

Given your API credentials, this endpoint will return all the products you have available for sale. This includes details about the product itself, and a JSON Schema representation of the brief clients fill in to purchase this product.
Example request:
curl -X GET https://api.99designs.com/resources/v1/products -H "Content-Type:application/json"
Example response(s):
200Products
{
  "products": [
    {
      "id": "website-revamp-v1",
      "title": "Website redesign",
      "description": "Have one of our talented creators give your existing website a makeover.",
      "price": 12345,
      "details": {
        "title": "Up to 5 pages",
        "description": "Redesign available for a maximum of 5 pages."
      },
      "additionalDetails": {
        "title": "Excludes hosting",
        "description": "Product price does not include hosting cost or setup"
      }
    }
  ]
}
400Bad request
{
  "message": "An error has occurred"
}