{
  "aid": "printful.com:main-1.0",
  "name": "Printful API",
  "type": "Index",
  "description": "# About the Printful API\nThe Printful API is a RESTful API, that uses an HTTP protocol for communication. HTTP GET, POST, PUT and DELETE methods are used to access the API resources.\n\n## Requests and responses\n\n### Request endpoint\nAll API requests have to be sent to this URL:\n```\nhttps://api.printful.com/\n```\nIf you are using a proxy, make sure that all requests have host header set to **api.printful.com**.\n\n### Request parameters\nSome mandatory parameters (like object identifiers) must be included in the request URL path\n```\nGET /orders/123\n```\nAdditional parameters can be passed as GET variables:\n```\nGET /orders?offset=10&limit=5\n```\nFor POST and PUT requests, a more complex data structure can be passed as JSON encoded data in the request body:\n```\nPOST /orders\n\n{\"recipient\":{...},\"items\":[...]}\n```\n\n### Response body\nThe response body is always a JSON object that contains a response status code (identical to the HTTP status code) and the result of the action. If the status code is 200, then the action was successful.\n```\n{\n   \"code\": 200, //Response status code\n   \"result\":{\n      //API method return data\n\t  //...\n   }\n}\n```\n\nSometimes the response includes paging information to allow to browse larger result sets by adding offset and limit GET parameters to the request URL.\n```\n{\n   \"code\": 200, //Response status code\n   \"result\":[\n\t   {\n\t      //Item 11\n\t   },\n\t   {\n\t      //Item 12\n\t   }\n   ]\n   \"paging\": {\n      \"total\": 12,  //Total items available\n      \"offset\": 10, //Items skipped from the beginning\n      \"limit\": 20   //Number of items per page\n   }\n}\n```\n\n## Error response\nIf the API call is not successful, then the response code is not in the 2xx range and the `result` attribute contains an error description.\n```\n{\n    \"code\": 404,\n    \"result\": \"Not Found\",\n    \"error\": {\n        \"reason\": \"NotFound\",\n        \"message\": \"Not Found\"\n    }\n}\n```\n\nIn general, response codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, etc.), and codes in the 5xx range indicate an error with Printful's servers.\n\n### Timestamps\nAll timestamps from the API are returned as integers in UNIX timestamp format.\n\n### Rate Limits\nPrintful API has a general rate limit of 120 API calls per minute. Additionally, endpoints that perform resource intensive operations (such as mockup generator) have a lower allowed request limit.\n\n# Authentication\n\n<!-- ReDoc-Inject: <security-definitions> -->",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/printful.com/main/1.0/apis.json",
  "tags": [
    "printful.com",
    "main"
  ],
  "created": "2026-03-29",
  "modified": "2026-03-29",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "printful.com:main-1.0",
      "name": "Printful API",
      "description": "# About the Printful API\nThe Printful API is a RESTful API, that uses an HTTP protocol for communication. HTTP GET, POST, PUT and DELETE methods are used to access the API resources.\n\n## Requests and responses\n\n### Request endpoint\nAll API requests have to be sent to this URL:\n```\nhttps://api.printful.com/\n```\nIf you are using a proxy, make sure that all requests have host header set to **api.printful.com**.\n\n### Request parameters\nSome mandatory parameters (like object identifiers) must be included in the request URL path\n```\nGET /orders/123\n```\nAdditional parameters can be passed as GET variables:\n```\nGET /orders?offset=10&limit=5\n```\nFor POST and PUT requests, a more complex data structure can be passed as JSON encoded data in the request body:\n```\nPOST /orders\n\n{\"recipient\":{...},\"items\":[...]}\n```\n\n### Response body\nThe response body is always a JSON object that contains a response status code (identical to the HTTP status code) and the result of the action. If the status code is 200, then the action was successful.\n```\n{\n   \"code\": 200, //Response status code\n   \"result\":{\n      //API method return data\n\t  //...\n   }\n}\n```\n\nSometimes the response includes paging information to allow to browse larger result sets by adding offset and limit GET parameters to the request URL.\n```\n{\n   \"code\": 200, //Response status code\n   \"result\":[\n\t   {\n\t      //Item 11\n\t   },\n\t   {\n\t      //Item 12\n\t   }\n   ]\n   \"paging\": {\n      \"total\": 12,  //Total items available\n      \"offset\": 10, //Items skipped from the beginning\n      \"limit\": 20   //Number of items per page\n   }\n}\n```\n\n## Error response\nIf the API call is not successful, then the response code is not in the 2xx range and the `result` attribute contains an error description.\n```\n{\n    \"code\": 404,\n    \"result\": \"Not Found\",\n    \"error\": {\n        \"reason\": \"NotFound\",\n        \"message\": \"Not Found\"\n    }\n}\n```\n\nIn general, response codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, etc.), and codes in the 5xx range indicate an error with Printful's servers.\n\n### Timestamps\nAll timestamps from the API are returned as integers in UNIX timestamp format.\n\n### Rate Limits\nPrintful API has a general rate limit of 120 API calls per minute. Additionally, endpoints that perform resource intensive operations (such as mockup generator) have a lower allowed request limit.\n\n# Authentication\n\n<!-- ReDoc-Inject: <security-definitions> -->",
      "image": "https://static.cdn.printful.com/dist-pf/image-assets/off-center-full-color-black.1de1e822b15b8e74075c8d1fa631d4e3.svg",
      "baseURL": "https://api.printful.com",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/printful.com/main/1.0",
      "version": "1.0",
      "tags": [
        "printful.com",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/printful.com/main/1.0/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/printful.com/main/1.0"
        }
      ],
      "contact": [
        {
          "FN": "Printful developer support",
          "email": "devsupport@printful.com",
          "url": "https://www.printful.com/docs/support"
        }
      ]
    }
  ]
}