Erply Export API

The Export API from Erply — 3 operation(s) for export.

Operations 3

GET /v1/export/assortments Get Assortments Export
GET /v1/export/matrix-products Get Matrix Products Export
GET /v1/export/products Get Products Export

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/erply-export-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

erply-export-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: "\n\n## Overview\n\n\n\nThis application offers an API for managing assignments and tasks.\n\n\n\nGraphQL endpoint for the same API is [also available](/graph)\n\n\n\n<details><summary>Authentication</summary>\n\n\n\n> \n\n> Authenticate using your Erply credentials and get a sessionKey. This sessionKey and your Erply clientCode must be provided in the HTTP headers of every request. You do not have to authenticate against this API - valid Erply sessionKey-s from other sources are also acceptable. To authenticate using this API, use the `POST /api/v1/auth` endpoint.\n\n>\n\n</details>\n\n"
  title: assignments Assortment Export API
  contact: {}
  version: 2.36.5
tags:
- name: Export
paths:
  /v1/export/assortments:
    get:
      security:
      - sk: []
      - cc: []
      - jwt: []
      description: You can export all the assortments, as well as filter by the ids.
      tags:
      - Export
      summary: Get Assortments Export
      parameters:
      - description: export by assortment IDs. The parameter can contain semicolon delimited IDs.
        name: assortmentID
        in: query
        schema:
          type: integer
      - description: Supply the warehouse IDs to get the values for stock, price and warehousePrice. The parameter can contain semicolon delimited IDs. To get a list of warehouse IDs, make an Account Admin API call GET /v1/warehouse, using corresponding endpoint for your account. https://api-am-eu10.erply.com/documentation/index.html#/warehouse/get_v1_warehouse
        name: warehouseIds
        in: query
        schema:
          type: array
          items:
            type: integer
      responses:
        '200':
          description: binary xlsx file content
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
  /v1/export/matrix-products:
    get:
      security:
      - sk: []
      - cc: []
      - jwt: []
      tags:
      - Export
      summary: Get Matrix Products Export
      parameters:
      - description: filter by the matrix product ids. The parameter can contain semicolon delimited IDs.
        name: ids
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the status. By default all records except archived are returned
        name: status
        in: query
        schema:
          type: string
          enum:
          - ACTIVE
          - ARCHIVED
          - NO_LONGER_ORDERED
          - NOT_FOR_SALE
      - description: filter by the group ids. The parameter can contain semicolon delimited IDs.
        name: groupIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the category ids. The parameter can contain semicolon delimited IDs.
        name: categoryIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the brand ids. The parameter can contain semicolon delimited IDs.
        name: brandIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the supplier ids. The parameter can contain semicolon delimited IDs.
        name: supplierIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the priority group ids. The parameter can contain semicolon delimited IDs.
        name: priorityGroupIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the family ids. The parameter can contain semicolon delimited IDs.
        name: familyIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: Supply the warehouse IDs to get the values for stock, price and warehousePrice. The parameter can contain semicolon delimited IDs. To get a list of warehouse IDs, make an Account Admin API call GET /v1/warehouse, using corresponding endpoint for your account. https://api-am-eu10.erply.com/documentation/index.html#/warehouse/get_v1_warehouse
        name: warehouseIds
        in: query
        schema:
          type: array
          items:
            type: integer
      responses:
        '200':
          description: binary xlsx file content
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
  /v1/export/products:
    get:
      security:
      - sk: []
      - cc: []
      - jwt: []
      description: By default the endpoint exports all the products, but you can apply filtering with the parameters below
      tags:
      - Export
      summary: Get Products Export
      parameters:
      - description: export only selected product IDs. The parameter can contain semicolon delimited IDs.
        name: ids
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the status. By default all records except archived are returned
        name: status
        in: query
        schema:
          type: string
          enum:
          - ACTIVE
          - ARCHIVED
          - NO_LONGER_ORDERED
          - NOT_FOR_SALE
      - description: filter by the group ids. The parameter can contain semicolon delimited IDs.
        name: groupIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the unit ids. The parameter can contain semicolon delimited IDs.
        name: unitIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the tax rate ids. The parameter can contain semicolon delimited IDs.
        name: taxRateIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the category ids. The parameter can contain semicolon delimited IDs.
        name: categoryIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the brand ids. The parameter can contain semicolon delimited IDs.
        name: brandIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the supplier ids. The parameter can contain semicolon delimited IDs.
        name: supplierIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the priority group ids. The parameter can contain semicolon delimited IDs.
        name: priorityGroupIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the country ids. The parameter can contain semicolon delimited IDs.
        name: countryIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: Supply the warehouse IDs to get the values for stock, price and warehousePrice. The parameter can contain semicolon delimited IDs. To get a list of warehouse IDs, make an Account Admin API call GET /v1/warehouse, using corresponding endpoint for your account. https://api-am-eu10.erply.com/documentation/index.html#/warehouse/get_v1_warehouse
        name: warehouseIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the warehouse location ids. The parameter can contain semicolon delimited IDs.
        name: warehouseLocationIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the parent product ids. The parameter can contain semicolon delimited IDs.
        name: parentProductIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the deposit fee ids. The parameter can contain semicolon delimited IDs.
        name: depositFeeIds
        in: query
        schema:
          type: array
          items:
            type: integer
      - description: filter by the family ids. The parameter can contain semicolon delimited IDs.
        name: familyIds
        in: query
        schema:
          type: array
          items:
            type: integer
      responses:
        '200':
          description: binary xlsx file content
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.MessageResponse'
components:
  schemas:
    responses.MessageResponse:
      type: object
      properties:
        message:
          type: string
          example: some message
  securitySchemes:
    AccessToken:
      type: apiKey
      name: accessToken
      in: header
    ErplyClientCode:
      type: apiKey
      name: clientCode
      in: header
    ErplyJWT:
      type: apiKey
      name: jwt
      in: header
    ErplySession:
      type: apiKey
      name: sessionKey
      in: header
    RequestKey:
      type: apiKey
      name: requestKey
      in: header