For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data Source

Seller and data source information

Retrieve data source (seller) detail

get

Returns detailed information about a specific data source (seller/merchant).

Data Sources: In marketplace scenarios, data sources represent different sellers or merchants offering products. This endpoint provides seller information including:

  • Business contact details

  • Legal information (MERSIS, KEP)

  • Additional seller-specific data

Path parameters
pkintegerRequired

Unique identifier of the data source.

Example: 42
Responses
200

Data source detail retrieved successfully

application/json

Detailed seller/data source information.

pkintegerOptional

Data source identifier

Example: 42
namestringOptional

Internal name of the data source.

Example: seller-premium-electronics
titlestringOptional

Display title of the seller.

Example: Premium Electronics Store
addressstringOptional

Business address of the seller.

Example: 123 Commerce Street, Business District
emailstring · emailOptional

Contact email address.

Example: contact@akinon.com
phone_numberstringOptional

Contact phone number.

Example: +90 212 555 1234
fax_numberstring · nullableOptional

Fax number (if available).

Example: +90 212 555 1235
kep_addressstring · nullableOptional

Registered Electronic Mail (KEP) address.

Required for official business correspondence in Turkey.

Example: seller@hs01.kep.tr
mersis_numberstring · nullableOptional

Central Registration System (MERSIS) number.

Unique business registration number in Turkey.

Example: 0123456789012345
get/datasources/{pk}/
GET /datasources/{pk}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*
{
  "pk": 42,
  "name": "seller-premium-electronics",
  "title": "Premium Electronics Store",
  "address": "123 Commerce Street, Business District",
  "email": "contact@akinon.com",
  "phone_number": "+90 212 555 1234",
  "fax_number": "+90 212 555 1235",
  "kep_address": "seller@hs01.kep.tr",
  "mersis_number": "0123456789012345",
  "extras": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Retrieve sellers offering a product

get

Returns all sellers (data sources) that offer a specific product, including their prices and stock levels.

Marketplace Support: For marketplace storefronts with multiple sellers, this endpoint provides:

  • All sellers offering the product

  • Seller-specific pricing

  • Seller-specific stock availability

  • Seller details for comparison

Response: Returns an array of seller offers, each containing:

  • Seller information (contact, business details)

  • Price data (price, retail price, currency)

  • Stock information (quantity, availability)

Path parameters
pkintegerRequired

Unique identifier of the product.

Example: 12345
Responses
200

Product sellers retrieved successfully

application/json

Seller's offer for a product including price and stock.

get/product/{pk}/datasources/
GET /product/{pk}/datasources/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*
[
  {
    "datasource": {
      "pk": 42,
      "name": "seller-123",
      "slug": "premium-electronics",
      "title": "Premium Electronics Store",
      "supplier_code": "SUP-001",
      "address": "123 Commerce Street, Business District",
      "email": "seller@akinon.com",
      "phone_number": "+90 212 555 1234",
      "fax_number": null,
      "kep_address": null,
      "mersis_number": null,
      "trade_association": "Istanbul Chamber of Commerce",
      "extras": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "price_list": null,
      "stock_list": null,
      "is_active": true
    },
    "stock": {
      "pk": 1,
      "product": 1,
      "stock": 15,
      "unit_type": "quantity",
      "stock_list": 1,
      "stock_list_detailed": {
        "pk": 1,
        "name": "text",
        "code": "text"
      },
      "extra_field": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    },
    "price": {
      "pk": 1,
      "product": 1,
      "price": "129.99",
      "retail_price": "159.99",
      "currency_type": "try",
      "tax_rate": "18.00",
      "price_list": 1,
      "price_list_detailed": {
        "pk": 1,
        "name": "text",
        "code": "text",
        "currency": "text"
      },
      "extra_field": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  }
]

Last updated

Was this helpful?