1. Master
VasyOpenAPI
  • Branch
    • Branch List
      GET
  • Department
    • department
      GET
  • Category
    • category
      GET
    • subCategory
      GET
  • Brand
    • Brand
      GET
    • SubBrand
      GET
  • Contact
    • Get Customer List W Branch Id
      GET
    • Get Contact By Id
      GET
    • Get Contact By Mobile No
      GET
    • contactSave
      POST
    • Supplier(Party)
      GET
  • GST
    • Verify GST
      POST
  • Master
    • Get Country List
      GET
    • Get State List
      GET
    • Get City List
      GET
    • Get Tax List
      GET
    • Get Additional Charge List
      GET
  • Product
    • Get Product List
      GET
    • Get Product By ID
      GET
    • products with inventory
      GET
    • product details with Inventory By Product ID
      GET
    • Product Variant List ID & Name
      GET
    • Variant Details By Variant ID
      GET
  • Recipe
    • Get All Recipe
  • User
    • Created By
  • Report
    • Get Sales Item Register Data
    • Purchase Item Register Report
    • Stock Summary Report
    • Stock Transfer Item Register Report
    • Consumption Production Report
  • Sales
    • Get All Sales Data
    • Get Sales Data By Id
    • Order Create
    • Order Status
    • Shipping Details
    • Update Due Date
    • Update Order Status
  1. Master

Get Country List

GET
/api/v1/master/location/country

Country List#

Purpose#

Retrieve the list of countries available in VasyERP.

Why would you use this?#

Use this API when your system needs country master data for customer management, supplier management, address validation, onboarding forms, or other location-based operations.

Information Required#

FieldRequiredDescription
api-tokenYesAuthentication token provided by VasyERP

Information Returned#

This API returns country master information including:
Country ID
Country Code
Country Name
Currency Code
Currency Name
Currency Symbol
Country Dial Code Prefix

Example Use Case#

A customer registration form requires users to select their country.
Instead of maintaining a separate country list, the application can fetch the latest country master data from DB and populate the country dropdown automatically.

Important Notes#

Country IDs should be stored and used when referencing countries in other APIs.
Country codes follow standard country abbreviations (e.g., IN, US, UK).
Country dial code prefixes can be used for validating phone numbers and contact details.

Request

Header Params

Responses

🟢200
application/json
Bodyapplication/json

🟠403Unauthorized
🟠429Too Many Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/master/location/country' \
--header 'api-token: {{.in-api-token}}'
Response Response Example
200 - Example 1
{
    "status": true,
    "message": "All Country List",
    "code": "200",
    "response": [
        {
            "countryId": 1,
            "countryCode": "AF",
            "countryName": "Afghanistan",
            "currencyCode": null,
            "currencyName": null,
            "currencySymbol": null,
            "countryDialCodePrefix": 93
        },
        {
            "countryId": 2,
            "countryCode": "AL",
            "countryName": "Albania",
            "currencyCode": null,
            "currencyName": null,
            "currencySymbol": null,
            "countryDialCodePrefix": 355
        }
    ]
}
Previous
Verify GST
Next
Get State List
Built with