SalesChannelDistricts

Retrieve Sales Channel District

get

Retrieve a specific Sales Channel District by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200
Sales Channel District retrieved successfully
application/json
get
GET /api/v1/channel/{channel_id}/districts/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "pk": 1,
  "name": "Davutpasa",
  "is_active": true,
  "city": 1,
  "township": 1,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "zipcode": "34000",
  "created_date": "2025-06-27T09:42:32.557Z",
  "modified_date": "2025-06-27T09:42:32.557Z"
}

Update Sales Channel District

put

Update a specific Sales Channel District by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerRead-onlyOptional

Primary key of the district

namestring · stringRequired

District Name

Example: Davutpasa
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

townshipinteger · int64Required

Related Township ID

postcodestring · stringOptional

Postcode

Example: 34000
zipcodestring · stringOptional

Zipcode

Example: 34000
Responses
200
Sales Channel District updated
put
PUT /api/v1/channel/{channel_id}/districts/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "name": "Davutpasa",
  "is_active": true,
  "city": 1,
  "township": 1,
  "postcode": "34000",
  "zipcode": "34000",
  "modified_date": "2025-06-27T09:42:32.557Z"
}

No content

Delete Sales Channel District

delete

Delete a specific Sales Channel District by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
204
Sales Channel District deleted successfully
delete
DELETE /api/v1/channel/{channel_id}/districts/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Partial Update Sales Channel District

patch

Partial update a specific Sales Channel District by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerRead-onlyOptional

Primary key of the district

namestring · stringRequired

District Name

Example: Davutpasa
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

townshipinteger · int64Required

Related Township ID

postcodestring · stringOptional

Postcode

Example: 34000
zipcodestring · stringOptional

Zipcode

Example: 34000
Responses
200
Sales Channel District updated
patch
PATCH /api/v1/channel/{channel_id}/districts/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "name": "Davutpasa",
  "is_active": true,
  "city": 1,
  "township": 1,
  "postcode": "34000",
  "zipcode": "34000",
  "modified_date": "2025-06-27T09:42:32.557Z"
}

No content

Retrieve Sales Channel District with details

get

Retrieve a specific Sales Channel District by ID with details

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200
Sales Channel District retrieved successfully with details
application/json
get
GET /api/v1/channel/{channel_id}/districts/{id}/detailed/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "city": 1,
  "township": 1,
  "pk": 1,
  "name": "Davutpasa",
  "is_active": true,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "zipcode": "34000",
  "created_date": "2025-06-27T09:42:32.557Z",
  "modified_date": "2025-06-27T09:42:32.557Z"
}

List Sales Channel Districts

get

List Sales Channel Districts

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
name__exactstringOptional

Filters by exact name

mapping__integration_typestring · enumOptional

Filter by integration mapping object's integration type

Possible values:
mapping__code__exactstringOptional

Filter by integration mapping object's code

hyperbooleanOptional

Activate id to hyperlink the response data.

city_idinteger · min: 1Optional

Filter by City ID

township_idinteger · min: 1Optional

Filter by Township ID

postcodestringOptional

Filter by Postcode

Responses
200
OK
application/json
get
GET /api/v1/channel/{channel_id}/districts/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "count": 0,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "created_date": "2025-06-27T09:42:32.557Z",
      "modified_date": "2025-06-27T09:42:32.557Z"
    }
  ]
}

Create Sales Channel District

post

Create Sales Channel District

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Body
pkintegerRead-onlyOptional

Primary key of the district

namestring · stringRequired

District Name

Example: Davutpasa
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

townshipinteger · int64Required

Related Township ID

postcodestring · stringOptional

Postcode

Example: 34000
zipcodestring · stringOptional

Zipcode

Example: 34000
Responses
201
Sales Channel District Created
application/json
post
POST /api/v1/channel/{channel_id}/districts/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "name": "Davutpasa",
  "is_active": true,
  "city": 1,
  "township": 1,
  "postcode": "34000",
  "zipcode": "34000",
  "modified_date": "2025-06-27T09:42:32.557Z"
}
{
  "pk": 1,
  "name": "Davutpasa",
  "is_active": true,
  "city": 1,
  "township": 1,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "zipcode": "34000",
  "created_date": "2025-06-27T09:42:32.557Z",
  "modified_date": "2025-06-27T09:42:32.557Z"
}

List Districts with details

get

List Districts with details

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
name__exactstringOptional

Filters by exact name

mapping__integration_typestring · enumOptional

Filter by integration mapping object's integration type

Possible values:
mapping__code__exactstringOptional

Filter by integration mapping object's code

hyperbooleanOptional

Activate id to hyperlink the response data.

city_idinteger · min: 1Optional

Filter by City ID

township_idinteger · min: 1Optional

Filter by Township ID

postcodestringOptional

Filter by Postcode

Responses
200
OK
application/json
get
GET /api/v1/channel/{channel_id}/districts/detailed/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "count": 0,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "pk": 1,
      "name": "Davutpasa",
      "is_active": true,
      "city": 1,
      "township": 1,
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "postcode": "34000",
      "zipcode": "34000",
      "created_date": "2025-06-27T09:42:32.557Z",
      "modified_date": "2025-06-27T09:42:32.557Z"
    }
  ]
}

Was this helpful?