Production Data API

Query and ingest time-series production data for wells.

Endpoints

Method	Path	Description
GET	/projects/{projectId}/wells/{wellId}/production	Get production data for a well
POST	/projects/{projectId}/wells/{wellId}/production	Ingest production records
DELETE	/projects/{projectId}/wells/{wellId}/production	Delete production records by date range

---

GET Production Data

GET /projects/{projectId}/wells/{wellId}/production

Query Parameters

Parameter	Type	Required	Description
from	ISO 8601 date	Yes	Start date (inclusive)
to	ISO 8601 date	Yes	End date (inclusive)
fields	string[]	No	Comma-separated list of fields to return
aggregation	string	No	daily (default), monthly

Example Request

curl "https://your-org.tachyus.com/api/v1/projects/proj-001/wells/well-001/production\
?from=2025-01-01&to=2025-03-31&fields=oil_rate,water_rate,gas_rate" \
  -H "Authorization: Bearer $TACHAPPS_API_TOKEN"

Response

{
  "wellId": "well-001",
  "from": "2025-01-01",
  "to": "2025-03-31",
  "aggregation": "daily",
  "fields": ["date", "oil_rate", "water_rate", "gas_rate"],
  "data": [
    { "date": "2025-01-01", "oil_rate": 450.2, "water_rate": 1200.8, "gas_rate": 325.0 },
    { "date": "2025-01-02", "oil_rate": 448.7, "water_rate": 1215.3, "gas_rate": 318.5 }
  ]
}

---

POST — Ingest Production Records

POST /projects/{projectId}/wells/{wellId}/production

Accepts an array of daily production records. Existing records for the same date are upserted (replaced).

Request Body

{
  "records": [
    { "date": "2026-01-01", "oil_rate": 512.3, "water_rate": 890.1, "gas_rate": 410.0 },
    { "date": "2026-01-02", "oil_rate": 508.7, "water_rate": 895.6, "gas_rate": 405.3 }
  ]
}

Response — 200 OK

{
  "inserted": 1,
  "updated": 1,
  "total": 2
}

TIP

For bulk historical imports (thousands of records), use the CSV import endpoint or contact your Tachyus engineer for a bulk data migration.

---

DELETE — Remove Production Records

DELETE /projects/{projectId}/wells/{wellId}/production?from=2026-01-01&to=2026-01-31

Query Parameters

Parameter	Type	Required	Description
from	ISO 8601 date	Yes	Start of range to delete (inclusive)
to	ISO 8601 date	Yes	End of range to delete (inclusive)

Response — 200 OK

{ "deleted": 31 }

---

Available Fields

Field	Description	Unit (Imperial)
oil_rate	Daily oil production rate	bbl/d
water_rate	Daily water production rate	bbl/d
gas_rate	Daily gas production rate	Mscf/d
bhp	Bottom-hole pressure	psi
thp	Tubing head pressure	psi
choke_size	Choke size	64ths inch
runtime	Daily pump runtime	hrs
gor	Gas-oil ratio	scf/bbl
watercut	Water fraction	%

---

Next Steps

• Authentication →
• Projects API →