Getting Started
Overview
REST Resources

Create a Geophrase



HTTP request

POST https://api.geophrase.com/business/geophrases/





Example request
curl --location 'https://api.geophrase.com/business/geophrases/' \
--header 'X-API-Key: {API key}' \
--header 'Content-Type: application/json' \
--data '{
  "latitude": 25.0000000000001,
  "longitude": 45.78473662999998,
  "address_line_one": "House no 49",
  "address_line_two": "Gulab Nagar Ln",
  "landmark": "Near Mukul Ram Store",
  "city": "New Delhi",
  "address_type": "HOME",
  "postal_code": 110001
}'

Request headers

Header NameValue

X-API-Key

Required
{API key}

Content-Type

Required
application/json


Request body

The request body contains JSON object in following format.

{
  "latitude": 25.0000000000001,
  "longitude": 45.78473662999998,
  "address_line_one": "House no 49",
  "address_line_two": "Gulab Nagar Ln",
  "landmark": "Near Mukul Ram Store",
  "city": "New Delhi",
  "address_type": "HOME",
  "postal_code": 110001
}

Field NameValue

latitude

Required
Number

longitude

Required
Number

address_line_one

Required
String

address_line_two

Required
String

landmark

Optional
String

city

Required
String

address_type

Required
String
Allowed values are: HOME and WORK

postal_code

Required
Number
Must be a valid and real postal code


Response

Returns status code 201 and an instance of Geophrase.



Error response

Returns 4xx HTTP status code and an error response.


Status CodeDescription

403

Consider these reasons:

  • Missing or incorrect X-API-Key header

  • Insufficient wallet balance

  • Read-only API key cannot perform write operation.



Next step

Update a Geophrase

© theFront. 2025, Maccarian. All rights reserved