Introduction

The Platform API allows developers to manage a Fynd Platform company programmatically, providing access to the same data and operations available to merchants in the platform panel. Key features include managing products, tracking and updating inventory across locations, viewing and fulfilling orders, and more.
There are two variants of the Platform API, based on the granularity of data access:

1. Company Level: Requires the company_id parameter and provides access to data across the entire company, including all its applications (sales channels). Example: getApplications API fetches a list of applications within a company.
2. Application Level: Requires both company_id and application_id parameters and provides access to data for a specific application within the company. Example: getAppProducts API retrieves all products associated with an application.

Download the Postman collection

---

Client Libraries

Use our official API client libraries to easily interact with our APIs in the programming language of your choice

Javascript

Java

Python

Kotlin

Swift

---

Authentication

To interact with our Platform APIs, you'll need a valid access token. Depending upon your use case, you can obtain an access token in the following ways

1. For developing an extension
   • You need to implement OAuth in order to get access token for the companies that install your extension. Refer to this guide on implementing OAuth in extension.
2. For integrating a specific company on Fynd Platform to external systems
   • You can request an access token for the required company using client credentials of that company. Checkout how to obtain access token using client credentials.

Getting access token using client credentials

Requirements

• You've registered on the Fynd Platform and have access to any company.

Step 1: Retrieve client credentials

You can obtain your Client Id and Client Secret from platform panel. Follow the steps outlined below to retrieve the credentials for your company:

1. Log in to your Fynd Platform account.
2. Here, if you have access to any company you will get the screen to select a company, otherwise it will open Create Company form.
3. Select the company from the company list, it will open the Fynd Platform Dashboard.
4. Click on the Developers tab in the sidebar, which will open APIs & SDKs page.
5. Now, click on the clients tab and then click on Create Client and create the client by filling necessary details and permissions.
6. Now, you can check your client credentials here.

Step 2: Get an access token using client credentials

Now, to make a Platform API call you need a valid access token. You can retrieve an access token using your client credentials.

Note: An access token obtained through the client credentials flow is limited to accessing data from the single company associated with the credentials used to generate it.

You need to construct the API call as mentioned below and make a POST request to the /oauth/token endpoint. Include the parameters outlined below in the request body:

Header name	Description
Authorization	It's a combination of client_id and client_secret {client_id:client_secret} base64 string. Pass this token as a Basic {base64TokenString} in authorization header.

Refer following shell script to convert client_id and client_secret to base64TokenString

base64TokenString=$(echo -n {client_id}:{client_secret} | base64)

cURL

curl -X POST "https://api.fynd.com/service/panel/authentication/v1.0/company/{company_id}/oauth/token" \ 
-H "Authorization: Basic {base64TokenString}" \ 
-H 'Content-Type: application/json' \ 
-d '{"grant_type":"client_credentials"}'

Request Body

Parameter	Description
grant_type	Grant type to get access token. Here, pass grant_type as client_credentials.

Response

Upon a successful request, the server will respond with an access token as shown below:

{
  "access_token": <token>,
  "token_type": "Bearer",
  "expires_in": <ttl>,
  "expires_at": <timestamp>,
  "scope": [ ... ]
}

Step 3: Make authenticated requests to platform APIs

To make authenticated requests to Fynd platform APIs you need to pass an access token (retrieved in step 2) in the authorization header:

Authorization: Bearer <access_token>

Example: Authenticated request to platform API

curl -X GET "https://api.fynd.com/service/platform/configuration/v1.0/company/{company_id}/application" \ 
-H "Authorization: Bearer {access_token}"