# tarla.io API Documentation

## Docs

- [Authentication Token Refresh Operation](https://api-docs.tarla.io/api-reference/authentication-service/authentication-token-refresh-operation.md): When the Authentication Token expires, it is renewed using the refresh token
- [Login Operation](https://api-docs.tarla.io/api-reference/authentication-service/login-operation.md): Login Operations are Made With Username And Password
- [Logout Operation](https://api-docs.tarla.io/api-reference/authentication-service/logout-operation.md): Logout Operations Puts JWT In Blacklist
- [New User Registration](https://api-docs.tarla.io/api-reference/authentication-service/new-user-registration.md): New User Registration is Made
- [Find Paged Data Logs](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/find-paged-data-logs.md)
- [Find Single Station By ID](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/find-single-station-by-id.md)
- [Find Stations By City and District](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/find-stations-by-city-and-district.md)
- [Find Stations By Name Pattern](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/find-stations-by-name-pattern.md)
- [Get Cities](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/get-cities.md)
- [Get Districts of Given City](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/get-districts-of-given-city.md): Get the list of districts of a given city. Remember to use URL encoding for the city name having Turkish characters.
- [Lists stations paged](https://api-docs.tarla.io/api-reference/mgm-stations-data-api/lists-stations-paged.md)
- [Activate Account](https://api-docs.tarla.io/api-reference/user-accounts-service/activate-account.md): Activates the account using user ID, account ID, and email verification token.
- [Activate Phone Number](https://api-docs.tarla.io/api-reference/user-accounts-service/activate-phone-number.md): Activates the user's phone number using user ID, account ID, and phone verification token.
- [Create Account](https://api-docs.tarla.io/api-reference/user-accounts-service/create-account.md): Creates a new account with the provided details.
- [Get Account Details](https://api-docs.tarla.io/api-reference/user-accounts-service/get-account-details.md): Retrieves detailed information of the account associated with the specified user ID.
- [Request Account Activation](https://api-docs.tarla.io/api-reference/user-accounts-service/request-account-activation.md): Initiates the process of account activation by sending an activation email to the user.
- [Request Phone Number Activation](https://api-docs.tarla.io/api-reference/user-accounts-service/request-phone-number-activation.md): Starts the phone number activation process by sending a verification code to the user's phone.
- [Update Account](https://api-docs.tarla.io/api-reference/user-accounts-service/update-account.md): Updates account information such as email, phone, or other attributes.
- [Update Subscription Plan](https://api-docs.tarla.io/api-reference/user-accounts-service/update-subscription-plan.md): Updates the account's subscription plan with the provided details.
- [Change Password Operation](https://api-docs.tarla.io/api-reference/user-service/change-password-operation.md): The operation that allows a user to change their own password. A user cannot change another user's password through this operation!
- [Get Own User Information Operation](https://api-docs.tarla.io/api-reference/user-service/get-own-user-information-operation.md): Retrieves only the requester's own user details without providing any token
- [Get User Operation](https://api-docs.tarla.io/api-reference/user-service/get-user-operation.md): Can only be used by users with POWER_USER and higher roles. Retrieves user details with the given user identifier
- [New User Creation Operation](https://api-docs.tarla.io/api-reference/user-service/new-user-creation-operation.md): Can only be used by users with the ADMIN role. Creates a new user record with the provided details. If the password field is left blank, a random password of 12 alphanumeric characters is generated. After the user is created, a welcome email is sent to the relevant user's email address (username). P…
- [Pageable User Listing Operation](https://api-docs.tarla.io/api-reference/user-service/pageable-user-listing-operation.md): Can only be used by users with the ADMIN role. Retrieves registered users in the system pageably according to the given filter and sorting options
- [Password Reset Operation](https://api-docs.tarla.io/api-reference/user-service/password-reset-operation.md): Sent during the password reset request
- [Password Reset Request Operation](https://api-docs.tarla.io/api-reference/user-service/password-reset-request-operation.md): This is the operation that receives the password reset request from users who have forgotten their password. A limit is applied to the password reset request for a user within a certain period. When this limit is exceeded, an email is not sent again and an error message is returned.
- [User Unblocking Operation](https://api-docs.tarla.io/api-reference/user-service/user-unblocking-operation.md): Can only be used by users with the ADMIN role. A user who exceeds the number of unauthorized login attempts in the form of a brute-force attack is permanently blocked. This is the operation used to remove this block.
- [User Update Operation](https://api-docs.tarla.io/api-reference/user-service/user-update-operation.md): An operation where only users with the ADMIN role can update roles, status, and password; only users with POWER_USER and higher roles, along with the requesting user themselves, can change the username; and users with other roles can update the remaining fields.
- [Authentication](https://api-docs.tarla.io/en/api-reference/authentication.md): Authentication guarantees privacy of API Services by authenticating users. Authentication requires users to log in before accessing iklim.co API Services. This guide covers setup for each available handshake method.
- [User Settings](https://api-docs.tarla.io/en/api-reference/final-briefing.md): This page provides important information about the details required to make API requests, such as language selection, user registration, account activation and account subscription processes.
- [API Security](https://api-docs.tarla.io/en/api-reference/introduction.md): This page provides important information about the details you need to know before making API requests.
- [Introduction](https://api-docs.tarla.io/en/index.md): Welcome to the home of tarla.io API documentation

## OpenAPI Specs

- [mgm-stations-v1](https://api-docs.tarla.io/tr/open-api/mgm-stations-v1.json)
- [auth-version-1](https://api-docs.tarla.io/tr/open-api/auth-version-1.json)
- [accounts-version-1](https://api-docs.tarla.io/tr/open-api/accounts-version-1.json)
- [openapi](https://api-docs.tarla.io/api-reference/openapi.json)