Profile and stores

Who the token belongs to — seller, countries, your connection — and the seller’s stores (boutiques).

Get the connected seller

GET/mescope profile:read

curl "https://coliswift.com/api/partner/v1/me" \
  -H "Authorization: Bearer $COLISWIFT_ACCESS_TOKEN"

const res = await fetch('https://coliswift.com/api/partner/v1/me', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.COLISWIFT_ACCESS_TOKEN}`,
  },
});
const data = await res.json();

$ch = curl_init('https://coliswift.com/api/partner/v1/me');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('COLISWIFT_ACCESS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

import os, requests

res = requests.get(
    "https://coliswift.com/api/partner/v1/me",
    headers={"Authorization": f"Bearer {os.environ['COLISWIFT_ACCESS_TOKEN']}"},
)
data = res.json()

Response

{
  "seller": {
    "id": "6a1c2f0e-3b7d-4c55-9e10-2f8a4b7c9d01",
    "name": "Samira Benali",
    "email": "seller@example.com",
    "companyName": "Atlas Beauty",
    "countries": [
      "MA"
    ]
  },
  "client": {
    "id": "b7e2c4a1-9f3d-4e6b-8a20-5c1d7e9f0a3b",
    "name": "Your App"
  },
  "grant": {
    "id": "f3a9d2c1-7e5b-4a8f-9c60-1b2d3e4f5a6b",
    "scopes": [
      "profile:read",
      "catalogue:read",
      "orders:write",
      "orders:read"
    ],
    "createdAt": "2026-11-02T09:14:03.000Z"
  },
  "stores": [
    {
      "id": "b2d4e6f8-1a3c-4e5f-8a9b-0c1d2e3f4a5b",
      "name": "atlas-beauty.example",
      "countryCode": "MA",
      "status": "active"
    }
  ]
}

seller.idstring: Seller id — the same as seller_id in the token response and webhook envelopes.
seller.namestring: First and last name.
seller.emailstring | null: Account e-mail.
seller.companyNamestring | null: Company name.
seller.countriesstring[]: Primary country first, then the additional ones, upper case. The only countries the seller can use in any call.
clientobject: id and name of your app as ColiSwift knows it.
grantobject: id, scopes (all scopes of the connection) and createdAt of the connection.
stores[]object[]: id, name, countryCode, status of every store of the seller, by name.

List stores

GET/storesscope products:write

curl "https://coliswift.com/api/partner/v1/stores" \
  -H "Authorization: Bearer $COLISWIFT_ACCESS_TOKEN"

const res = await fetch('https://coliswift.com/api/partner/v1/stores', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.COLISWIFT_ACCESS_TOKEN}`,
  },
});
const data = await res.json();

$ch = curl_init('https://coliswift.com/api/partner/v1/stores');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('COLISWIFT_ACCESS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

import os, requests

res = requests.get(
    "https://coliswift.com/api/partner/v1/stores",
    headers={"Authorization": f"Bearer {os.environ['COLISWIFT_ACCESS_TOKEN']}"},
)
data = res.json()

Response

{
  "data": [
    {
      "id": "b2d4e6f8-1a3c-4e5f-8a9b-0c1d2e3f4a5b",
      "name": "atlas-beauty.example",
      "countryCode": "MA",
      "url": "https://atlas-beauty.example",
      "status": "active"
    }
  ]
}

Create a store

POST/storesscope products:write

namestringrequired: Store name.
countryCodestring (2): Country of the store.
urlURL: Public address of the shop.

curl -X POST "https://coliswift.com/api/partner/v1/stores" \
  -H "Authorization: Bearer $COLISWIFT_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "atlas-beauty.example",
  "countryCode": "MA",
  "url": "https://atlas-beauty.example"
}'

const res = await fetch('https://coliswift.com/api/partner/v1/stores', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.COLISWIFT_ACCESS_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "atlas-beauty.example",
    "countryCode": "MA",
    "url": "https://atlas-beauty.example"
  }),
});
const data = await res.json();

$ch = curl_init('https://coliswift.com/api/partner/v1/stores');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('COLISWIFT_ACCESS_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => <<<'JSON'
{
  "name": "atlas-beauty.example",
  "countryCode": "MA",
  "url": "https://atlas-beauty.example"
}
JSON,
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

import os, requests

res = requests.post(
    "https://coliswift.com/api/partner/v1/stores",
    headers={"Authorization": f"Bearer {os.environ['COLISWIFT_ACCESS_TOKEN']}"},
    json={
        "name": "atlas-beauty.example",
        "countryCode": "MA",
        "url": "https://atlas-beauty.example",
    },
)
data = res.json()

Answers 201 with the created store as ColiSwift stores it. Use its id as storeId on products and orders.