LogoLogo
  • Welcome to Akinon Documentation
  • Products
    • ACC
    • Omnitron
    • Commerce
    • Order Management System (OMS)
    • Instore
    • Integrator
    • Marketplace Dashboard (MPD)
    • Project Zero (PZ)
    • Seller Center
    • Akifast
    • App Maker
  • API Reference
    • Welcome to Akinon API Reference
  • Omnitron
    • Getting Started
    • Integration
      • Product
        • Product
        • Pre-Product
        • Attribute
        • Attribute Value
        • Attribute Set
        • Product Image
      • Price
        • Price List
        • Product Price
        • Currency Unit Table
      • Stock
        • Stock List
        • Product Stock
      • Order
        • Get Orders
        • Search Order
        • Get Order Detail by Order Number
        • Get Order Item Detail
        • Orders ID Detail Integration
        • Orders Waiting to Send to ERP
        • Update Order and Order Item
        • Stock Reservation Release
        • Order Cancellation
        • Cancellation & Refund Pending Orders
        • Order Discount Items
        • Order Status Codes & Cancellation Statuses
      • Migration
        • Getting Started
        • User Migration
        • Address Migration
        • Old Order Migration
        • Old Order Item Migration
        • View Migration Progress
        • Currency Options
    • PIM
      • Attributes & Sets
      • Mapping
      • Localization
      • Media
    • Catalogue
      • Introduction
      • Price List
      • Stock List
      • Catalogue Item
      • Category Trees
      • Product Collection
      • Product Sorting
    • Channels
      • Introduction
      • Payments
      • Customers
    • Order
      • Getting Started
      • Fulfillment
      • Cancellations & Refunds
    • Retail Stores
      • Retail Stores
    • User Management
      • Roles & Permissions
      • Add & Remove
    • Whippy Ware
      • Introduction
      • Stock
      • Stock Lists
      • Stock List Rules
      • Stock Providers
      • Stock Locations
  • Omnitron OpenAPIs
    • Without Server
      • Customers
      • Reporting
      • Deleted Items
      • Pos
      • AttributeValues
      • Attribute Values
      • Providers
      • LDAPProviders
      • Healthcheck
      • LoyaltyTransactions
      • Policies
      • Exports
      • Dashboard
      • AuthTOTP
      • Price Lists
      • ProductPrices
      • Districts
      • Cities
      • Countries
      • Townships
      • PrometheusMetrics
      • Language
      • Content Types
      • Mappings
      • Applications
      • ApplicationPermissions
      • Error Reports
      • MailTemplates
      • UploadLogo
      • SalesChannelMarketPlaceAttributeSetConfig
      • SalesChannelCancellationRequestImage
      • SalesChannelCities
      • SalesChannelCancellationReasons
      • SalesChannelCargoCompany
      • SalesChannelProductImage
      • SalesChannelAttributeConfig
      • SalesChannelAttributeValueConfig
      • SalesChannelTownships
      • SalesChannelCustomers
      • SalesChannelFailedIntegrations
      • SalesChannelGetStockList
      • SalesChannelRetailStore
      • IntegrationActions
      • SalesChannelOrderShippingInfo
      • SalesChannelBatchRequests
      • SalesChannelAddresses
      • SalesChannelMarketPlaceAttributeSet
      • SalesChannelErrorReports
      • SalesChannelCategoryNodes
      • SalesChannelDistricts
      • SalesChannelProductStock
      • SalesChannelExtraProductStock
      • SalesChannelOrders
      • SalesChannelCancellationPlans
      • SalesChannelExtraProductPrices
      • SalesChannelProduct
      • SalesChannelAttributeSchemas
      • SalesChannelProductCategories
      • SalesChannelCancellationRequests
      • SalesChannelMarketPlaceAttributeValue
      • SalesChannelMappedProduct
      • SalesChannelMarketPlaceAttribute
      • SalesChannelOrderItem
      • SalesChannelProductPrice
      • SalesChannelCreateOrder
      • GetPriceList
      • SalesChannelCountries
      • SalesChannelGetPriceList
      • SalesChannelCategoryTree
    • With Server
      • Customers
      • Reporting
      • Deleted Items
      • Pos
      • AttributeValues
      • Attribute Values
      • Providers
      • LDAPProviders
      • Healthcheck
      • LoyaltyTransactions
      • Policies
      • Exports
      • Dashboard
      • AuthTOTP
      • Price Lists
      • ProductPrices
      • Districts
      • Cities
      • Countries
      • Townships
      • PrometheusMetrics
      • Language
      • Mappings
      • Content Types
      • Applications
      • ApplicationPermissions
      • Error Reports
      • MailTemplates
      • UploadLogo
      • SalesChannelMarketPlaceAttributeSetConfig
      • SalesChannelCancellationRequestImage
      • SalesChannelCities
      • SalesChannelCancellationReasons
      • SalesChannelCargoCompany
      • SalesChannelProductImage
      • SalesChannelAttributeConfig
      • SalesChannelAttributeValueConfig
      • SalesChannelTownships
      • SalesChannelCustomers
      • SalesChannelFailedIntegrations
      • SalesChannelGetStockList
      • IntegrationActions
      • SalesChannelRetailStore
      • SalesChannelOrderShippingInfo
      • SalesChannelBatchRequests
      • SalesChannelAddresses
      • SalesChannelMarketPlaceAttributeSet
      • SalesChannelErrorReports
      • SalesChannelDistricts
      • SalesChannelCategoryNodes
      • SalesChannelProductStock
      • SalesChannelExtraProductStock
      • SalesChannelCountries
      • SalesChannelOrders
      • SalesChannelProduct
      • SalesChannelCancellationPlans
      • SalesChannelExtraProductPrices
      • SalesChannelProductCategories
      • SalesChannelAttributeSchemas
      • SalesChannelCancellationRequests
      • SalesChannelMarketPlaceAttributeValue
      • SalesChannelMappedProduct
      • SalesChannelMarketPlaceAttribute
      • SalesChannelOrderItem
      • SalesChannelProductPrice
      • SalesChannelCreateOrder
      • GetPriceList
      • SalesChannelGetPriceList
      • SalesChannelCategoryTree
  • Commerce
    • Users
      • Getting Started
      • User Management & Authentication
      • Password & OTP Operations
      • User Profile & Segment Management
      • User Payment & Card Management
      • User Orders & Cancellations
      • Anonymous User Orders & Cancellations
      • User Support & Conversation
      • Captcha Validation
      • Currency & Akifast Operations
    • Checkout
      • Payment Related
      • Payment Strategy Related
      • Shipping Related
      • Independent Pages
    • Product
    • User Collections
    • Basket
    • Discount
    • Autocomplete
    • Breadcrumb
    • Pretty URLs
    • Menu
    • Widgets
    • Loyalty Accounts
    • Address Migration
    • Index Configuration
    • Favourite Products
    • User Address
    • Data Warehouse
    • Introduction
      • Filtering Parameters
    • Data Warehouse
    • Default
  • OMS
    • Package Services
    • Package Item Services
    • Package Denial Reason Services
    • Order Services
    • Order Item Services
    • Transfer Order Services
    • Transfer Item Services
    • Channel Services
    • Cancellation Plan Services
    • Cancellation Reason Services
    • Address Setup Services
    • City Services
    • District Services
    • Township Services
    • Stock Location Address Services
    • Webhook Setup Services
    • Webhook Event Services
    • Omnitron Order Webhooks
    • Undelivered Webhook Event Services
    • Inventory Discrepancy Services
    • OMS Setup Services
    • UI Settings Services
    • OMS Audit Events Service
    • Customer Address Services
    • Application Settings Services
    • Content Type Services
    • Customer Services
    • Channel Setup Services
    • Demo Data Service
    • Order Execution Plan Services
    • Invoice Services
    • Localization Services
    • Action Log Services
    • Order Log Services
    • Celery Metrics Service
    • Stock Location Services
    • Stock Location Address Services
    • Stock Location Sender Address Services
    • Stock Location Sender Address Setup Services
    • Cargo Company Condition Services
    • Permission Group Services
  • OMS OpenAPIs
    • Package Services
      • Default
    • Transfer Order Services
      • Default
  • Instore
    • Password Reset Services
  • Integrator
    • Projects
    • Flows
    • Logs
  • Seller Center
    • Languages
    • Categories
    • Introduction
    • Products
    • Packages
    • Orders
    • Claims
    • Shipping Methods
  • Akifast
    • Authentication
  • B2B
    • Quotation
    • Basket
    • Division
    • User
    • Staff User
    • Groups
    • Notification
    • Notification Template
  • Flows
    • Shipment Flows
    • Payment Flows
    • SMS Flows
    • Basket Offer Flows
Powered by GitBook

© 2025 Akinon. All rights reserved.

On this page

Was this helpful?

  1. Omnitron OpenAPIs
  2. With Server

Townships

PreviousCountriesNextPrometheusMetrics

Was this helpful?

Delete Township

delete

Delete a specific Township by ID

Authorizations
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
204
Township deleted successfully
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
delete
DELETE /api/v1/townships/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Retrieve Township with details

get

Retrieve a specific Township by ID with details

Authorizations
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200
Township retrieved successfully with details
application/json
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
get
GET /api/v1/townships/{id}/detailed/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "city": 1,
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "created_date": "2025-05-22T09:45:52.923Z",
  "modified_date": "2025-05-22T09:45:52.923Z"
}

List Townships

get

List Townships

Authorizations
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

name__iexactstringOptional

Filters case insensitive 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.

priorityintegerOptional

Filter by priority

Example: 1
city_idinteger · min: 1Optional

Filter by City ID

postcodestringOptional

Filter by Postcode

pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

Responses
200
OK
application/json
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
get
GET /api/v1/townships/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "count": 0,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "created_date": "2025-05-22T09:45:52.923Z",
      "modified_date": "2025-05-22T09:45:52.923Z"
    }
  ]
}

List Townships with details

get

List Townships with details

Authorizations
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

name__iexactstringOptional

Filters case insensitive 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.

priorityintegerOptional

Filter by priority

Example: 1
city_idinteger · min: 1Optional

Filter by City ID

postcodestringOptional

Filter by Postcode

pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

Responses
200
OK
application/json
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
get
GET /api/v1/townships/detailed/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "count": 0,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "pk": 1,
      "name": "Esenler",
      "is_active": true,
      "city": 1,
      "translations": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "postcode": "34000",
      "created_date": "2025-05-22T09:45:52.923Z",
      "modified_date": "2025-05-22T09:45:52.923Z"
    }
  ]
}
  • GETRetrieve Township
  • PUTUpdate Township
  • DELETEDelete Township
  • PATCHPartial Update Township
  • GETRetrieve Township with details
  • GETList Townships
  • POSTCreate Township
  • GETList Townships with details

Retrieve Township

get

Retrieve a specific Township by ID

Authorizations
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200
Township retrieved successfully
application/json
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
get
GET /api/v1/townships/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "city": 1,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "created_date": "2025-05-22T09:45:52.923Z",
  "modified_date": "2025-05-22T09:45:52.923Z"
}

Update Township

put

Update a specific Township by ID

Authorizations
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerOptional

Primary key of the township

namestring · stringRequired

Township Name

Example: Esenler
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

postcodestring · stringOptional

Postcode

Example: 34000
Responses
200
Township updated
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
put
PUT /api/v1/townships/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "city": 1,
  "postcode": "34000",
  "modified_date": "2025-05-22T09:45:52.923Z"
}

No content

Partial Update Township

patch

Partial update a specific Township by ID

Authorizations
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerOptional

Primary key of the township

namestring · stringRequired

Township Name

Example: Esenler
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

postcodestring · stringOptional

Postcode

Example: 34000
Responses
200
Township updated
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
patch
PATCH /api/v1/townships/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "city": 1,
  "postcode": "34000",
  "modified_date": "2025-05-22T09:45:52.923Z"
}

No content

Create Township

post

Create Township

Authorizations
Body
pkintegerOptional

Primary key of the township

namestring · stringRequired

Township Name

Example: Esenler
is_activebooleanOptional

Is it active? (True/False)

Example: true
cityinteger · int64Required

Related City ID

postcodestring · stringOptional

Postcode

Example: 34000
Responses
201
Township Created
application/json
401
Unauthorized Access
application/json
404
The given resource or object was not found or does not exist.
application/json
500
Server Error
post
POST /api/v1/townships/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "city": 1,
  "postcode": "34000",
  "modified_date": "2025-05-22T09:45:52.923Z"
}
{
  "pk": 1,
  "name": "Esenler",
  "is_active": true,
  "city": 1,
  "translations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "postcode": "34000",
  "created_date": "2025-05-22T09:45:52.923Z",
  "modified_date": "2025-05-22T09:45:52.923Z"
}