Sign up
All data sources

iWell

Premium

iWell is production software for small and mid-size oil and gas operators. It covers wells, tanks, tank readings, run tickets, meters, production, fields, notes, and well tests.

oil-and-gas
Try iWell free for 14 daysGet the full contract and schemas as JSONConnect this source →

Premium: 14-day free trial with your iWell key, then Professional ($500/user/mo).

What you can ask

  • “What does iWell have for the area or asset I'm working on?”
  • “Pull the most recent iWell records and put them in a table.”
  • “What does iWell cover, and how fresh is the data?”

About this source

iWell field-data platform: pumper data, tanks, meters, production, run tickets, well groups, custom fields, validation, notes. Auth: OAuth2 password grant (client_id, client_secret, username, password). Token cached 7 days. Rate: 24 req/min. Date params: `since` = UNIX epoch seconds (30-day lookback). `start`/`end` = YYYY-MM-DD inclusive, 30-day window max (server enforces 30 even though docs say 31). `hourly=true` on tank readings requires start===end. Numeric updated_by/author fields → call list_users_map for {id:name} dict. 73 provider operations plus 2 helpers. DELETEs and iWell's inconsistent user-to-well verifier are omitted; use get_wells_well_id_users_user_id for access verification.

Connector ID iwell

Provenance

PublisheriWell
API basehttps://api.iwell.info/v1

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (Bearer token)

› Methods (75)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • get_me

    read

    Get account information for the authenticated user.

    Entitiesrecord
    Paginationnone

  • get_users

    read

    List all company users (iWell).

    Entitiesrecord
    Paginationnone

  • post_users

    write

    Create a new user.

    Entitiesrecord
    Paginationnone

  • get_users_user_id

    read

    Get single user.

    Required paramsuser_id
    Entitiesrecord
    Paginationnone

  • patch_users_user_id

    write

    Update user.

    Required paramsuser_id
    Entitiesrecord
    Paginationnone

  • get_users_user_id_wells

    read

    List wells accessible by the user. since=UNIX epoch (30d lookback).

    Required paramsuser_id
    Entitieswell
    Paginationnone

  • post_users_user_id_wells_well_id

    write

    Grant well access to the user.

    Required paramsuser_idwell_id
    Entitieswell
    Paginationnone

  • get_users_user_id_well_groups

    read

    List well groups accessible by the user. since=UNIX epoch (30d lookback).

    Required paramsuser_id
    Entitieswell
    Paginationnone

  • get_users_user_id_well_groups_group_id

    read

    Verify if the well group can be accessed by the user.

    Required paramsuser_idgroup_id
    Entitieswell
    Paginationnone

  • post_users_user_id_well_groups_group_id

    write

    Grant well group access to the user (iWell).

    Required paramsuser_idgroup_id
    Entitieswell
    Paginationnone

  • get_wells

    read

    List every iWell company well. Upstream iWell only supports `since`; `limit` and `offset` are applied client-side by the connector after fetching the list.

    Entitieswell
    Paginationoffset (offsetField: offset, limitField: limit)

    since=epoch (30d). limit/offset client-side. Group: get_well_groups_id_wells.

  • post_wells

    write

    Create a new well (iWell).

    Entitieswell
    Paginationnone

  • get_wells_well_id

    read

    Get a single well by `well_id`.

    Required paramswell_id
    Entitieswell
    Paginationnone

  • patch_wells_well_id

    write

    Update an existing well (iWell).

    Required paramswell_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_users

    read

    List users with access to this well. since=UNIX epoch (30d lookback).

    Required paramswell_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_users_user_id

    read

    Verify if the user have access to the well.

    Required paramswell_iduser_id
    Entitieswell
    Paginationnone

  • post_wells_well_id_users_user_id

    write

    Grant well access to the user.

    Required paramswell_iduser_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_tanks

    read

    List tanks allocated to this well. since=UNIX epoch (30d lookback).

    Required paramswell_id
    Entitiesfacility, well
    Paginationnone

  • get_wells_well_id_tanks_tank_id

    read

    Verify if the tank is allocated to the well.

    Required paramswell_idtank_id
    Entitiesfacility, well
    Paginationnone

  • post_wells_well_id_tanks_tank_id

    write

    Allocate the tank to the well.

    Required paramswell_idtank_id
    Entitiesfacility, well
    Paginationnone

  • get_tanks

    read

    Get all tanks. Date param: since is a UNIX epoch integer (30-day lookback max).

    Entitiesfacility
    Paginationnone

  • post_tanks

    write

    Create new tank

    Entitiesfacility
    Paginationnone

  • get_tanks_tank_id

    read

    Get a single tank

    Required paramstank_id
    Entitiesfacility
    Paginationnone

  • patch_tanks_tank_id

    write

    Update the stored settings of one tank by its tank identifier.

    Required paramstank_id
    Entitiesfacility
    Paginationnone

  • get_tanks_tank_id_readings

    read

    List tank readings. start/end YYYY-MM-DD (30d window). hourly=true needs start===end.

    Required paramstank_id
    Entitiesfacility
    Paginationnone

    Do not pass epochs to start/end. updated_by → list_users_map.

  • post_tanks_tank_id_readings

    write

    Create tank reading. The previous portion of the reading is optional.

    Required paramstank_id
    Entitiesfacility
    Paginationnone

  • get_tanks_tank_id_readings_reading_id

    read

    Get single tank reading.

    Required paramstank_idreading_id
    Entitiesfacility
    Paginationnone

    updated_by → list_users_map. hourly=true needs start===end.

  • patch_tanks_tank_id_readings_reading_id

    write

    Update tank reading. The previous portion of the reading is optional.

    Required paramstank_idreading_id
    Entitiesfacility
    Paginationnone

  • get_tanks_tank_id_readings_reading_id_run_tickets

    read

    Get run tickets on a tank reading. since=UNIX epoch (30d).

    Required paramstank_idreading_id
    Entitiesrun ticket
    Paginationnone

    updated_by → list_users_map.

  • post_tanks_tank_id_readings_reading_id_run_tickets

    write

    Create run ticket.

    Required paramstank_idreading_id
    Entitiesfacility
    Paginationnone

  • get_tanks_tank_id_readings_reading_id_run_tickets_run_ticket_id

    read

    Get single run ticket.

    Required paramstank_idreading_idrun_ticket_id
    Entitiesrun ticket
    Paginationnone

    updated_by → list_users_map.

  • patch_tanks_tank_id_readings_reading_id_run_tickets_run_ticket_id

    write

    Update run ticket.

    Required paramstank_idreading_idrun_ticket_id
    Entitiesfacility
    Paginationnone

  • get_wells_well_id_meters

    read

    Get the meters for the well. Date param: since is a UNIX epoch integer (30-day lookback max).

    Required paramswell_id
    Entitiesfacility, well
    Paginationnone

  • post_wells_well_id_meters

    write

    Create new meter.

    Required paramswell_id
    Entitiesfacility, well
    Paginationnone

  • get_wells_well_id_meters_meter_id

    read

    Get single meter.

    Required paramswell_idmeter_id
    Entitiesfacility, well
    Paginationnone

  • patch_wells_well_id_meters_meter_id

    write

    Update meter.

    Required paramswell_idmeter_id
    Entitiesfacility, well
    Paginationnone

  • get_wells_well_id_meters_meter_id_readings

    read

    Get meter readings. start/end YYYY-MM-DD (30d window).

    Required paramswell_idmeter_id
    Entitiesfacility, well
    Paginationnone

    No epochs in start/end. updated_by → list_users_map.

  • post_wells_well_id_meters_meter_id_readings

    write

    Create meter reading.

    Required paramswell_idmeter_id
    Entitiesfacility, well
    Paginationnone

  • get_wells_well_id_meters_meter_id_readings_reading_id

    read

    Get single meter reading.

    Required paramswell_idmeter_idreading_id
    Entitiesfacility, well
    Paginationnone

    updated_by → list_users_map.

  • patch_wells_well_id_meters_meter_id_readings_reading_id

    write

    Update reading.

    Required paramswell_idmeter_idreading_id
    Entitiesfacility, well
    Paginationnone

  • get_wells_well_id_production

    read

    Get production data for a well (iWell). start/end YYYY-MM-DD (30d window).

    Required paramswell_id
    Entitiesproduction, well
    Paginationnone

    No epochs in start/end. updated_by → list_users_map.

  • post_wells_well_id_production

    write

    Create new production data (iWell).

    Required paramswell_id
    Entitiesproduction, well
    Paginationnone

  • get_wells_well_id_production_production_id

    read

    Get a single production record.

    Required paramswell_idproduction_id
    Entitiesproduction, well
    Paginationnone

    updated_by → list_users_map.

  • patch_wells_well_id_production_production_id

    write

    Update production (iWell).

    Required paramswell_idproduction_id
    Entitiesproduction, well
    Paginationnone

  • get_well_groups

    read

    List all company well groups. Date param: since is a UNIX epoch integer (30-day lookback max).

    Entitieswell
    Paginationnone

  • post_well_groups

    write

    Create a new group.

    Entitieswell
    Paginationnone

  • get_well_groups_group_id

    read

    Get single group (iWell).

    Required paramsgroup_id
    Entitieswell
    Paginationnone

  • patch_well_groups_group_id

    write

    Update well group (iWell).

    Required paramsgroup_id
    Entitieswell
    Paginationnone

  • get_well_groups_group_id_wells

    read

    Retrieve list of wells in well group (iWell).

    Required paramsgroup_id
    Entitieswell
    Paginationnone

  • get_well_groups_group_id_wells_well_id

    read

    Verify if the well is part of the well group.

    Required paramsgroup_idwell_id
    Entitieswell
    Paginationnone

  • post_well_groups_group_id_wells_well_id

    write

    Add well to well group.

    Required paramsgroup_idwell_id
    Entitieswell
    Paginationnone

  • get_well_groups_group_id_users

    read

    List users with access to the well group. since=UNIX epoch (30d).

    Required paramsgroup_id
    Entitieswell
    Paginationnone

  • get_well_groups_group_id_users_user_id

    read

    Verify if the user have access to the well group.

    Required paramsgroup_iduser_id
    Entitieswell
    Paginationnone

  • post_well_groups_group_id_users_user_id

    write

    Grant well group access to the user (iWell).

    Required paramsgroup_iduser_id
    Entitieswell
    Paginationnone

  • get_fields

    read

    Get all custom fields. Date param: since is a UNIX epoch integer (30-day lookback max).

    Entitiesfield
    Paginationnone

  • post_fields

    write

    Create field.

    Entitiesfield
    Paginationnone

  • get_fields_field_id

    read

    Get single field.

    Required paramsfield_id
    Entitiesfield
    Paginationnone

  • patch_fields_field_id

    write

    Update field (iWell).

    Required paramsfield_id
    Entitiesfield
    Paginationnone

  • get_wells_well_id_fields

    read

    Get all fields assigned for this well.

    Required paramswell_id
    Entitiesfield, well
    Paginationnone

  • get_wells_well_id_fields_field_id_values

    read

    Get field values for a well. start/end YYYY-MM-DD (30d window).

    Required paramswell_idfield_id
    Entitiesfield, well
    Paginationnone

    No epochs in start/end.

  • post_wells_well_id_fields_field_id_values

    write

    Create a field value for a specific well.

    Required paramswell_idfield_id
    Entitiesfield, well
    Paginationnone

  • get_wells_well_id_fields_field_id_values_value_id

    read

    Get field value for a specific well.

    Required paramswell_idfield_idvalue_id
    Entitiesfield, well
    Paginationnone

  • patch_wells_well_id_fields_field_id_values_value_id

    write

    Update field value for a specific well.

    Required paramswell_idfield_idvalue_id
    Entitiesfield, well
    Paginationnone

  • get_wells_well_id_validation_rules

    read

    Get validation rules for well. Date param: since is a UNIX epoch integer (30-day lookback max).

    Required paramswell_id
    Entitieswell
    Paginationnone

  • post_wells_well_id_validation_rules

    write

    Create a new validation rule for well.

    Required paramswell_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_validation_rules_rule_id

    read

    Get single validation rule.

    Required paramswell_idrule_id
    Entitieswell
    Paginationnone

  • patch_wells_well_id_validation_rules_rule_id

    write

    Update validation rule.

    Required paramswell_idrule_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_notes

    read

    Get notes on the well. since=UNIX epoch (30d).

    Required paramswell_id
    Entitieswell
    Paginationnone

    author → list_users_map.

  • post_wells_well_id_notes

    write

    Create a new note.

    Required paramswell_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_notes_note_id

    read

    Get single note.

    Required paramswell_idnote_id
    Entitieswell
    Paginationnone

    author → list_users_map.

  • patch_wells_well_id_notes_note_id

    write

    Update note.

    Required paramswell_idnote_id
    Entitieswell
    Paginationnone

  • get_wells_well_id_well_tests

    read

    List well tests for a well. start/end YYYY-MM-DD (30d window).

    Required paramswell_id
    Entitiescompletion, well
    Paginationnone

    No epochs in start/end.

  • get_wells_well_id_well_tests_well_test_id

    read

    Get a single well test.

    Required paramswell_idwell_test_id
    Entitiescompletion, well
    Paginationnone

  • find_wells_by_name

    read

    Client-side name/alias substring filter over the company wells list. Use this instead of guessing unsupported server-side filters on `get_wells`.

    Required paramsquery
    Entitieswell
    Paginationoffset (offsetField: offset, limitField: limit)

    Filters: type ("OIL"/"WATER"), is_active. One get_wells call.

  • list_users_map

    read

    Return a compact `{id: name}` map of company users for humanizing numeric `updated_by` and `author` fields.

    Entitiesrecord
    Paginationnone