The GET /api/users/countries endpoint allows you to retrieve a list of all countries registered in the system along with their two-digit ISO codes. This functionality is useful for populating dropdown lists or forms where a country selection is required, ensuring that the data remains consistent and up-to-date.
This endpoint is especially beneficial for applications that require geographical information, such as user profile creation, account settings, or any other functionality needing a list of countries.
Request Details
HTTP Method: GET
URL: /api/users/countries
Request Parameters
This endpoint does not require any parameters in the request.
Authentication Required
Example Request
GET /api/users/countries HTTP/1.1
Host: api.plaspy.com
Authorization: Bearer {your_auth_token}
Response Parameters
The response from this endpoint contains a structure that includes the status of the request and a list of countries. The following table describes the fields in the response:
| Field | Type | Required | Description |
|---|---|---|---|
| success | boolean | No | Indicates whether the request was successful. |
| error | string | No | Contains the error message if success is false. |
| apiUsage | integer | No | Current API usage by the user. |
| apiDailyUsage | integer | No | Daily API usage by the user. |
| countries | object | No | An object with two-digit ISO codes and country names. |
Example Successful Response
{
"success": true,
"apiUsage": 100,
"apiDailyUsage": 10,
"countries": {
"US": "United States",
"CA": "Canada",
"AR": "Argentina",
"BR": "Brazil",
"GB": "United Kingdom",
"CO": "Colombia"
}
}
Example Error Response
{
"success": false,
"error": "Authentication failed. Invalid token.",
"apiUsage": 100,
"apiDailyUsage": 10
}- Welcome to Plaspy help
- Map
- Viewing a Device's Route History
- Device Control Panel
- Detailed Device Information
- Buttons on the Map
- Details
- Trip Statistics
- Device Menu
- GeoFences
- Bulk Alert Editing
- Enable map notifications
- Mileage Calculation
- Atributes
- Devices
- Marker Icon
- Information
- Sensors
- Reassign Digital Sensors
- Commands
- Alerts
- Types
- Configuration
- Reminders
- Limits
- History
- Setting Up a New Tracker
- Solution for Identifier Already in Use by Another Account
- Device Issues
- Email alerts sending limits
- Reports
- New Report
- My Account
- Billing Information
- Password Change
- Email Notifications
- Telegram Accounts
- Update Mobile Phone Number
- Primary Email
- Alternative Email
- Activate Two-Factor Authentication (2FA)
- Access Log
- Password Recovery
- Recover Username
- Delete Your Account
- Subscription
- Sign Up
- Activation Code
- Payment Methods
- Line Renewal
- Free Version
- Settings
- Organization
- Login
- Contact
- Styles
- Maps
- Email Templates
- Push Notifications
- Telegram Notifications
- WhatsApp Notifications
- Mobile App
- Statistics
- Activity Summary
- Groups
- Users
- Share Access
- SMS
- Mobile Application
- Developers
- Enable the API
- Rest API
- Authentication
- Devices API
- GET /api/devices
- GET /api/devices/{deviceId}
- GET /api/devices/{deviceId}/lastLocation
- POST /api/devices/{deviceId}/locations
- POST /api/devices/{deviceId}/alerts
- Groups API
- GET /api/groups
- POST /api/groups
- GET /api/groups/{groupId}
- PUT /api/groups/{groupId}
- PATCH /api/groups/{groupId}
- DELETE /api/groups/{groupId}
- Users API
- GET /api/users
- POST /api/users
- GET /api/users/countries
- GET /api/users/timeZones
- GET /api/users/{userId}
- PUT /api/users/{userId}
- PATCH /api/users/{userId}
- DELETE /api/users/{userId}
- Embed login on my website
- Embed the map on my website
We answer all support request within 24 business hours approximately, If you have a question that needs an immediate resolution, please contact us by other way.
We answer you in business hours, as soon as possible. We are located in Bogotá, Colombia, time zone (GMT-5).