# User Addresses

Manage delivery addresses (login required)

## List Your Addresses

> Get all saved delivery addresses for the logged-in user.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/":{"get":{"tags":["User Addresses"],"summary":"List Your Addresses","description":"Get all saved delivery addresses for the logged-in user.","operationId":"listAddresses","parameters":[{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/PageParameter"},{"$ref":"#/components/parameters/PageSizeParameter"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"200":{"description":"List of addresses","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri","nullable":true},"previous":{"type":"string","format":"uri","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/Address"}}}}}}},"401":{"description":"Not logged in"}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"PageParameter":{"name":"page","in":"query","description":"Page number (starts from 1)","required":false,"schema":{"type":"integer","minimum":1,"default":1}},"PageSizeParameter":{"name":"page_size","in":"query","description":"Number of records per page","required":false,"schema":{"type":"integer","minimum":1,"default":10}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}},"schemas":{"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
```

## Add New Address

> Save a new delivery address.\
> \
> \*\*Related Settings\*\* (Omnitron → Sales Channels → Dynamic Settings):\
> \
> \- \*\*ADDRESS\_PHONE\_MIN\_LENGTH\*\* (Integer, default: \`11\`): Minimum phone number length. Example: Set to \`10\` for countries with shorter phone numbers.\
> \
> \- \*\*ADDRESS\_DISTRICT\_REQUIRED\*\* (Boolean, default: \`False\`): Makes district field mandatory. Set to \`true\` to require district selection.\
> \
> \- \*\*ADDRESS\_SERIALIZER\_FIELDS\*\* (Dictionary): Country-specific extra fields for addresses. Example:\
>   \`\`\`json\
>   {\
>     "TR": \[\
>       {"field": "tax\_office", "validators": \[], "kwargs": {}},\
>       {"field": "tax\_no", "validators": \[], "kwargs": {}}\
>     ]\
>   }\
>   \`\`\`\
>   Fields not in base Address model are stored in \`extra\_field\` JSON column.\
> \
> \- \*\*IDENTITY\_NUMBER\_VALIDATOR\*\* (String, default: \`"omnicore.address.validators.null\_identity\_validator"\`): \
>   Validates identity\_number field. Options:\
>   \- \`"omnicore.address.validators.null\_identity\_validator"\` - No validation\
>   \- \`"omnicore.address.validators.tc\_identity\_number\_validator"\` - Turkish ID validation\
> \
> \- \*\*IDENTITY\_NUMBER\_REQUIRED\_AMOUNT\*\* (Number, nullable, default: \`None\`): Order amount threshold requiring identity number. Example: \`5000\` means ID required for orders above 5000 TRY.\
> \
> \- \*\*ANONYMOUS\_ADDRESS\_EXPIRE\_SECONDS\*\* (Integer, default: \`1800\`): How long to keep guest user addresses before cleanup (30 minutes by default).

````json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/":{"post":{"tags":["User Addresses"],"summary":"Add New Address","description":"Save a new delivery address.\n\n**Related Settings** (Omnitron → Sales Channels → Dynamic Settings):\n\n- **ADDRESS_PHONE_MIN_LENGTH** (Integer, default: `11`): Minimum phone number length. Example: Set to `10` for countries with shorter phone numbers.\n\n- **ADDRESS_DISTRICT_REQUIRED** (Boolean, default: `False`): Makes district field mandatory. Set to `true` to require district selection.\n\n- **ADDRESS_SERIALIZER_FIELDS** (Dictionary): Country-specific extra fields for addresses. Example:\n  ```json\n  {\n    \"TR\": [\n      {\"field\": \"tax_office\", \"validators\": [], \"kwargs\": {}},\n      {\"field\": \"tax_no\", \"validators\": [], \"kwargs\": {}}\n    ]\n  }\n  ```\n  Fields not in base Address model are stored in `extra_field` JSON column.\n\n- **IDENTITY_NUMBER_VALIDATOR** (String, default: `\"omnicore.address.validators.null_identity_validator\"`): \n  Validates identity_number field. Options:\n  - `\"omnicore.address.validators.null_identity_validator\"` - No validation\n  - `\"omnicore.address.validators.tc_identity_number_validator\"` - Turkish ID validation\n\n- **IDENTITY_NUMBER_REQUIRED_AMOUNT** (Number, nullable, default: `None`): Order amount threshold requiring identity number. Example: `5000` means ID required for orders above 5000 TRY.\n\n- **ANONYMOUS_ADDRESS_EXPIRE_SECONDS** (Integer, default: `1800`): How long to keep guest user addresses before cleanup (30 minutes by default).","operationId":"createAddress","parameters":[{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"},{"$ref":"#/components/parameters/CSRFTokenHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressInput"}}}},"responses":{"201":{"description":"Address created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"400":{"description":"Validation error (invalid fields, city mismatch, etc.)","content":{"application/json":{"schema":{"type":"object","properties":{"field_name":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"429":{"description":"Too many requests (rate limit exceeded)","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}},"CSRFTokenHeader":{"name":"X-CSRFToken","in":"header","description":"CSRF token for write operations (POST, PUT, PATCH, DELETE).\nRequired for security when using session authentication.\nObtain token from cookie 'csrftoken' or meta tag in HTML.","required":true,"schema":{"type":"string"}}},"schemas":{"AddressInput":{"type":"object","description":"Input schema for creating/updating addresses","required":["first_name","last_name","phone_number","country","city","township","line","title"],"properties":{"email":{"type":"string","format":"email"},"phone_number":{"type":"string","description":"International format, min 11 chars (e.g., +905551234567)","minLength":11},"first_name":{"type":"string","minLength":2,"maxLength":30},"last_name":{"type":"string","minLength":2,"maxLength":30},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","minLength":10,"maxLength":512,"description":"Street address"},"title":{"type":"string","minLength":2,"maxLength":128,"description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","description":"District ID (optional unless ADDRESS_DISTRICT_REQUIRED=True)"},"postcode":{"type":"string"},"notes":{"type":"string"},"company_name":{"type":"string","maxLength":255},"tax_office":{"type":"string","maxLength":255},"tax_no":{"type":"string","maxLength":50},"e_bill_taxpayer":{"type":"boolean","description":"Registered for e-invoicing?"},"retail_store":{"type":"integer","description":"Retail store ID for click-and-collect orders"},"identity_number":{"type":"string","description":"National ID (may be required for large orders)"},"primary":{"type":"boolean","description":"Set as default address?"}}},"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
````

## Get Address Details

> View a specific address by ID.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/":{"get":{"tags":["User Addresses"],"summary":"Get Address Details","description":"View a specific address by ID.","operationId":"getAddress","parameters":[{"name":"pk","in":"path","required":true,"description":"Address ID","schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"200":{"description":"Address details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}},"schemas":{"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
```

## Update Address

> Replace all fields of an address.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/":{"put":{"tags":["User Addresses"],"summary":"Update Address","description":"Replace all fields of an address.","operationId":"updateAddress","parameters":[{"name":"pk","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"},{"$ref":"#/components/parameters/CSRFTokenHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressInput"}}}},"responses":{"200":{"description":"Address updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"400":{"description":"Validation error (invalid fields, city mismatch, etc.)","content":{"application/json":{"schema":{"type":"object","properties":{"field_name":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}},"CSRFTokenHeader":{"name":"X-CSRFToken","in":"header","description":"CSRF token for write operations (POST, PUT, PATCH, DELETE).\nRequired for security when using session authentication.\nObtain token from cookie 'csrftoken' or meta tag in HTML.","required":true,"schema":{"type":"string"}}},"schemas":{"AddressInput":{"type":"object","description":"Input schema for creating/updating addresses","required":["first_name","last_name","phone_number","country","city","township","line","title"],"properties":{"email":{"type":"string","format":"email"},"phone_number":{"type":"string","description":"International format, min 11 chars (e.g., +905551234567)","minLength":11},"first_name":{"type":"string","minLength":2,"maxLength":30},"last_name":{"type":"string","minLength":2,"maxLength":30},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","minLength":10,"maxLength":512,"description":"Street address"},"title":{"type":"string","minLength":2,"maxLength":128,"description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","description":"District ID (optional unless ADDRESS_DISTRICT_REQUIRED=True)"},"postcode":{"type":"string"},"notes":{"type":"string"},"company_name":{"type":"string","maxLength":255},"tax_office":{"type":"string","maxLength":255},"tax_no":{"type":"string","maxLength":50},"e_bill_taxpayer":{"type":"boolean","description":"Registered for e-invoicing?"},"retail_store":{"type":"integer","description":"Retail store ID for click-and-collect orders"},"identity_number":{"type":"string","description":"National ID (may be required for large orders)"},"primary":{"type":"boolean","description":"Set as default address?"}}},"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
```

## Delete Address

> Remove an address from your account.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/":{"delete":{"tags":["User Addresses"],"summary":"Delete Address","description":"Remove an address from your account.","operationId":"deleteAddress","parameters":[{"name":"pk","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"204":{"description":"Address deleted"},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}}}}
```

## Partially Update Address

> Update only specific fields.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/":{"patch":{"tags":["User Addresses"],"summary":"Partially Update Address","description":"Update only specific fields.","operationId":"partialUpdateAddress","parameters":[{"name":"pk","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"},{"$ref":"#/components/parameters/CSRFTokenHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressInput"}}}},"responses":{"200":{"description":"Address updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Address"}}}},"400":{"description":"Validation error (invalid fields)","content":{"application/json":{"schema":{"type":"object","properties":{"field_name":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}},"CSRFTokenHeader":{"name":"X-CSRFToken","in":"header","description":"CSRF token for write operations (POST, PUT, PATCH, DELETE).\nRequired for security when using session authentication.\nObtain token from cookie 'csrftoken' or meta tag in HTML.","required":true,"schema":{"type":"string"}}},"schemas":{"AddressInput":{"type":"object","description":"Input schema for creating/updating addresses","required":["first_name","last_name","phone_number","country","city","township","line","title"],"properties":{"email":{"type":"string","format":"email"},"phone_number":{"type":"string","description":"International format, min 11 chars (e.g., +905551234567)","minLength":11},"first_name":{"type":"string","minLength":2,"maxLength":30},"last_name":{"type":"string","minLength":2,"maxLength":30},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","minLength":10,"maxLength":512,"description":"Street address"},"title":{"type":"string","minLength":2,"maxLength":128,"description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","description":"District ID (optional unless ADDRESS_DISTRICT_REQUIRED=True)"},"postcode":{"type":"string"},"notes":{"type":"string"},"company_name":{"type":"string","maxLength":255},"tax_office":{"type":"string","maxLength":255},"tax_no":{"type":"string","maxLength":50},"e_bill_taxpayer":{"type":"boolean","description":"Registered for e-invoicing?"},"retail_store":{"type":"integer","description":"Retail store ID for click-and-collect orders"},"identity_number":{"type":"string","description":"National ID (may be required for large orders)"},"primary":{"type":"boolean","description":"Set as default address?"}}},"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
```

## Get Detailed Address

> View address with full geographic data (country, city, township, district objects).

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/detailed/":{"get":{"tags":["User Addresses"],"summary":"Get Detailed Address","description":"View address with full geographic data (country, city, township, district objects).","operationId":"getDetailedAddress","parameters":[{"name":"pk","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"200":{"description":"Detailed address data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressDetailed"}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}},"schemas":{"AddressDetailed":{"type":"object","description":"Address with expanded geographic data (full country, city, township, district, user, retail store objects)","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"$ref":"#/components/schemas/Country"},"city":{"$ref":"#/components/schemas/City"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"$ref":"#/components/schemas/Township"},"district":{"allOf":[{"$ref":"#/components/schemas/District"}],"nullable":true},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"allOf":[{"$ref":"#/components/schemas/RetailStore"}],"nullable":true,"description":"Retail store for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"object","readOnly":true,"description":"User object with id, email, first_name, last_name","properties":{"pk":{"type":"integer"},"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}}},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}},"Country":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"code":{"type":"string","description":"ISO 3166-1 alpha-2 code"},"translations":{"type":"object","nullable":true}}},"City":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"translations":{"type":"object","nullable":true},"priority":{"type":"integer"},"postcode":{"type":"string","nullable":true}}},"Township":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}},"District":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"township":{"type":"integer","description":"Township ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}},"RetailStore":{"type":"object","properties":{"pk":{"type":"integer"},"name":{"type":"string"},"township":{"type":"integer"},"district":{"type":"integer","nullable":true},"address":{"type":"string"},"phone_number":{"type":"string"},"fax_phone_number":{"type":"string","nullable":true},"image":{"type":"string","nullable":true,"description":"Image URL"},"image_path":{"type":"string","nullable":true},"erp_code":{"type":"string","nullable":true},"store_hours":{"type":"array","description":"Weekly store hours (7 days, each with [open, close] times)","items":{"type":"array","items":{"type":"string","format":"time","nullable":true}}},"latitude":{"type":"number","format":"float","nullable":true},"longitude":{"type":"number","format":"float","nullable":true},"is_active":{"type":"boolean"},"click_and_collect":{"type":"boolean","description":"Available for pickup orders?"},"store_type":{"type":"integer","nullable":true},"kapida_enabled":{"type":"boolean"},"fast_delivery":{"type":"boolean"},"config":{"type":"object"},"group":{"type":"integer","nullable":true},"sort_order":{"type":"integer"},"translations":{"type":"object"},"related_retail_stores":{"type":"array","items":{"type":"integer"}},"created_date":{"type":"string","format":"date-time"},"modified_date":{"type":"string","format":"date-time"}}}}}}
```

## Set Default Address

> Mark this address as your default.\
> \
> Send \`{"primary": true}\` to set as default address.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/{pk}/set-address/":{"patch":{"tags":["User Addresses"],"summary":"Set Default Address","description":"Mark this address as your default.\n\nSend `{\"primary\": true}` to set as default address.","operationId":"setDefaultAddress","parameters":[{"name":"pk","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/AcceptLanguageHeader"},{"$ref":"#/components/parameters/CSRFTokenHeader"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"primary":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Default address updated","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"}}}}}},"400":{"description":"Validation error (invalid primary value)","content":{"application/json":{"schema":{"type":"object","properties":{"field_name":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"404":{"description":"Address not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}},"CSRFTokenHeader":{"name":"X-CSRFToken","in":"header","description":"CSRF token for write operations (POST, PUT, PATCH, DELETE).\nRequired for security when using session authentication.\nObtain token from cookie 'csrftoken' or meta tag in HTML.","required":true,"schema":{"type":"string"}}},"schemas":{"Address":{"type":"object","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"city":{"type":"integer","description":"City ID"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"type":"integer","description":"Township ID"},"district":{"type":"integer","nullable":true,"description":"District ID"},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"type":"integer","nullable":true,"description":"Retail store ID for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"integer","readOnly":true,"description":"User ID"},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}}}}}
```

## List Detailed Addresses

> Get all addresses with full geographic data.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/detailed/":{"get":{"tags":["User Addresses"],"summary":"List Detailed Addresses","description":"Get all addresses with full geographic data.","operationId":"listDetailedAddresses","parameters":[{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/PageParameter"},{"$ref":"#/components/parameters/PageSizeParameter"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"200":{"description":"List of detailed addresses","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri","nullable":true},"previous":{"type":"string","format":"uri","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/AddressDetailed"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"PageParameter":{"name":"page","in":"query","description":"Page number (starts from 1)","required":false,"schema":{"type":"integer","minimum":1,"default":1}},"PageSizeParameter":{"name":"page_size","in":"query","description":"Number of records per page","required":false,"schema":{"type":"integer","minimum":1,"default":10}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}},"schemas":{"AddressDetailed":{"type":"object","description":"Address with expanded geographic data (full country, city, township, district, user, retail store objects)","properties":{"pk":{"type":"integer","description":"Address ID"},"email":{"type":"string","format":"email","nullable":true},"phone_number":{"type":"string","description":"International format (e.g., +905551234567)"},"first_name":{"type":"string"},"last_name":{"type":"string"},"country":{"$ref":"#/components/schemas/Country"},"city":{"$ref":"#/components/schemas/City"},"line":{"type":"string","description":"Street address, building, apartment"},"title":{"type":"string","description":"Address nickname (e.g., \"Ev\", \"İş\")"},"township":{"$ref":"#/components/schemas/Township"},"district":{"allOf":[{"$ref":"#/components/schemas/District"}],"nullable":true},"postcode":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"company_name":{"type":"string","nullable":true},"tax_office":{"type":"string","nullable":true},"tax_no":{"type":"string","nullable":true},"e_bill_taxpayer":{"type":"boolean","nullable":true,"description":"E-invoice taxpayer?"},"hash_data":{"type":"string","readOnly":true,"description":"Address hash for duplicate detection"},"address_type":{"type":"string","readOnly":true},"retail_store":{"allOf":[{"$ref":"#/components/schemas/RetailStore"}],"nullable":true,"description":"Retail store for click-and-collect"},"remote_id":{"type":"string","nullable":true,"description":"External provider address ID"},"identity_number":{"type":"string","nullable":true},"extra_field":{"type":"object","readOnly":true,"description":"Country-specific extra fields"},"user":{"type":"object","readOnly":true,"description":"User object with id, email, first_name, last_name","properties":{"pk":{"type":"integer"},"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}}},"is_corporate":{"type":"boolean","readOnly":true,"description":"Is this a corporate address?"},"primary":{"type":"boolean","description":"Is this the default address?"}}},"Country":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"code":{"type":"string","description":"ISO 3166-1 alpha-2 code"},"translations":{"type":"object","nullable":true}}},"City":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"translations":{"type":"object","nullable":true},"priority":{"type":"integer"},"postcode":{"type":"string","nullable":true}}},"Township":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}},"District":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"township":{"type":"integer","description":"Township ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}},"RetailStore":{"type":"object","properties":{"pk":{"type":"integer"},"name":{"type":"string"},"township":{"type":"integer"},"district":{"type":"integer","nullable":true},"address":{"type":"string"},"phone_number":{"type":"string"},"fax_phone_number":{"type":"string","nullable":true},"image":{"type":"string","nullable":true,"description":"Image URL"},"image_path":{"type":"string","nullable":true},"erp_code":{"type":"string","nullable":true},"store_hours":{"type":"array","description":"Weekly store hours (7 days, each with [open, close] times)","items":{"type":"array","items":{"type":"string","format":"time","nullable":true}}},"latitude":{"type":"number","format":"float","nullable":true},"longitude":{"type":"number","format":"float","nullable":true},"is_active":{"type":"boolean"},"click_and_collect":{"type":"boolean","description":"Available for pickup orders?"},"store_type":{"type":"integer","nullable":true},"kapida_enabled":{"type":"boolean"},"fast_delivery":{"type":"boolean"},"config":{"type":"object"},"group":{"type":"integer","nullable":true},"sort_order":{"type":"integer"},"translations":{"type":"object"},"related_retail_stores":{"type":"array","items":{"type":"integer"}},"created_date":{"type":"string","format":"date-time"},"modified_date":{"type":"string","format":"date-time"}}}}}}
```

## Search Addresses by Postcode

> Find addresses by postal code.\
> \
> Returns geographic data (country, city, township, district objects) matching the postcode.

```json
{"openapi":"3.0.3","info":{"title":"Address API","version":"1.0.0"},"tags":[{"name":"User Addresses","description":"Manage delivery addresses (login required)"}],"servers":[{"description":"Server base URL for address operations","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL"}}}],"paths":{"/address/query/":{"get":{"tags":["User Addresses"],"summary":"Search Addresses by Postcode","description":"Find addresses by postal code.\n\nReturns geographic data (country, city, township, district objects) matching the postcode.","operationId":"queryAddresses","parameters":[{"name":"postcode","in":"query","required":true,"description":"Postal code to search (minimum 1 character)","schema":{"type":"string","minLength":1}},{"name":"country","in":"query","required":false,"description":"Filter by country ID","schema":{"type":"integer"}},{"$ref":"#/components/parameters/CookieHeader"},{"$ref":"#/components/parameters/PageParameter"},{"$ref":"#/components/parameters/PageSizeParameter"},{"$ref":"#/components/parameters/AcceptLanguageHeader"}],"responses":{"200":{"description":"Matching geographic data","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri","nullable":true},"previous":{"type":"string","format":"uri","nullable":true},"results":{"type":"array","items":{"type":"object","properties":{"country":{"$ref":"#/components/schemas/Country"},"city":{"$ref":"#/components/schemas/City"},"township":{"$ref":"#/components/schemas/Township"},"district":{"allOf":[{"$ref":"#/components/schemas/District"}],"nullable":true}}}}}}}}},"400":{"description":"Validation error (invalid postcode format)","content":{"application/json":{"schema":{"type":"object","properties":{"field_name":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Not logged in","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}}}},"components":{"parameters":{"CookieHeader":{"name":"X-Cookie","in":"header","description":"Use the X-Cookie header instead of the Cookie header in the “TEST IT” section. When testing via Postman or other external tools, continue using the standard Cookie header. Some commerce applications may use 'sessionid' instead of 'osessionid'. Set 'ENABLE_X_COOKIE_HEADER = True' in your project environments to enable the “TEST IT” feature. This setting should be applied only for the “TEST IT” button.","required":true,"schema":{"type":"string"}},"PageParameter":{"name":"page","in":"query","description":"Page number (starts from 1)","required":false,"schema":{"type":"integer","minimum":1,"default":1}},"PageSizeParameter":{"name":"page_size","in":"query","description":"Number of records per page","required":false,"schema":{"type":"integer","minimum":1,"default":10}},"AcceptLanguageHeader":{"name":"Accept-Language","in":"header","description":"Language preference (for multilingual content).\nSupported languages: tr, en, ar, ru, de, fr","required":false,"schema":{"type":"string","enum":["tr","en","ar","ru","de","fr"],"default":"tr"}}},"schemas":{"Country":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"code":{"type":"string","description":"ISO 3166-1 alpha-2 code"},"translations":{"type":"object","nullable":true}}},"City":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"country":{"type":"integer","description":"Country ID"},"translations":{"type":"object","nullable":true},"priority":{"type":"integer"},"postcode":{"type":"string","nullable":true}}},"Township":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}},"District":{"type":"object","properties":{"pk":{"type":"integer"},"is_active":{"type":"boolean"},"name":{"type":"string"},"city":{"type":"integer","description":"City ID"},"township":{"type":"integer","description":"Township ID"},"postcode":{"type":"string","nullable":true},"translations":{"type":"object","nullable":true}}}}}}
```