1. Country State City
Fintainium APIs
  • Overview
  • Quick Start
  • Use Cases
  • Recipies
    • Connect with Vendor
    • Pay a Vendor
  • API Reference
    • AP Payouts (Accounts Payable)
      • Vendor (Recipient)
        • Create new vendor
        • Update Vendor
        • View Vendor Details
      • Payments (Payouts)
        • Initiate Payment
        • Add Payment Method
      • Bills
        • Create new Bill
      • Country State City
        • GET City List by State Name/ID/Code
          GET
    • AR Collection (Accounts Receivable)
      • Invoices
        • Create new Invoice
      • Customers
        • Create new customer
      • Payment (Collection)
        • Initiate Payment
        • Add Payment Method
    • Simplified Payouts
      • Send Payouts
    • Transactions
      • Retrieve Transaction Status
    • Webhooks
      • Register for an Event
      • Get Webhook Registration Status
    • Sub-Ledger
      • Retrieve Balance
  1. Country State City

GET City List by State Name/ID/Code

GET
https://staging-service.fintainium.com/api/city/getAllCityByState
The Get All Cities by State API retrieves a filtered, searchable, and paginated list of cities for a given state. It is commonly used to populate dropdowns, validate addresses, and standardize location data across vendor, customer, or business records.

Key Features#

Fetch all cities belonging to a state by providing stateId, stateCode, or stateName.
City name search: Use searchKey in combination with state identifiers to find specific cities.
Sorting support: Sort results by a given property (property) in ascending or descending order (direction).
Pagination support: Limit the number of results (limit) and fetch records after a certain point (since).
Flexible: Accepts additional optional parameters via [property: string]: any.

Request

Query Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://staging-service.fintainium.com/api/city/getAllCityByState?stateId=&stateName=&stateCode=&searchKey=&property=name&direction=true&since=0&limit=100'
Response Response Example
{
    "since": 0,
    "limit": 100,
    "total": 1,
    "entries": [
        {
            "id": 11743,
            "name": "Sylvan Beach"
        }
    ]
}
Modified at 2025-09-05 17:50:27
Previous
Create new Bill
Next
Create new Invoice
Built with