Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FlasheyEstudi/Oasis-Liquido/llms.txt

Use this file to discover all available pages before exploring further.

The Pharmacies API exposes the network of pharmacies registered on the Oasis Liquido platform. It powers the Aura Pharmacy Map feature, which shows users nearby locations with available medicines. Proximity search returns a distance_in_meters field so clients can sort or filter by distance. The single-pharmacy endpoint also returns live inventory via the available_medicines array.

​
GET /api/v1/pharmacies

Return a list of active pharmacies. Pass lat and lng to enable proximity ordering; distance_in_meters will be included in each result.

​
Query parameters

​
lat
number
Latitude of the user’s position for proximity search.
​
lng
number
Longitude of the user’s position for proximity search.
​
page
number
default:"1"
Page number.
​
limit
number
default:"20"
Results per page.

​
curl example

curl "http://localhost:8000/api/v1/pharmacies?lat=19.4326&lng=-99.1332" \
  --header "Authorization: Bearer <access_token>"

​
GET /api/v1/pharmacies/:id

Retrieve a single pharmacy by UUID, including its current medicine inventory in the available_medicines array.

​
Path parameters

​
id
string
required
UUID of the pharmacy.

​
curl example

curl http://localhost:8000/api/v1/pharmacies/pharm-uuid-001 \
  --header "Authorization: Bearer <access_token>"

​
POST /api/v1/pharmacies

Create a new pharmacy record. Requires the admin role.

​
Request body

​
name
string
required
The pharmacy’s display name.
​
address
string
required
Full street address.
​
latitude
number
required
Latitude coordinate (WGS 84).
​
longitude
number
required
Longitude coordinate (WGS 84).
​
phone
string
Optional contact phone number.

​
curl example

curl --request POST http://localhost:8000/api/v1/pharmacies \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Farmacia Oasis Express Norte",
    "address": "Calle Reforma 456, CDMX",
    "latitude": 19.4400,
    "longitude": -99.1500,
    "phone": "+52 55 1111 2222"
  }'

​
Pharmacy response fields

​
id
string
required
UUID of the pharmacy.
​
name
string
required
Pharmacy display name.
​
address
string
required
Full street address.
​
latitude
number
required
Latitude coordinate.
​
longitude
number
required
Longitude coordinate.
​
phone
string
Contact phone number.
​
is_active
boolean
required
Whether the pharmacy is currently operational.
​
distance_in_meters
number
Distance from the supplied lat/lng coordinates. Only present when proximity parameters are included in the request.
​
available_medicines
object[]
Real-time inventory snapshot. Only present on the single-pharmacy endpoint.
​
created_at
string
required
ISO 8601 creation timestamp.
​
updated_at
string
required
ISO 8601 last-updated timestamp.

Build docs developers (and LLMs) love

Get started for freeTalk to us