Skip to content
Hermes Health API
GuidesOpenAPI spec

Endpoints

Procedures

POST/v0/procedure-codes/browse

Browse procedure codes

Queries the CPT/HCPCS procedure code reference table, which is the same for every caller. Read-only. Uses the shared browse syntax described in Browsing tables and returns the { table, aggregate, total } envelope as JSON, or the selected columns as CSV when you send Accept: text/csv.

Request bodyapplication/json

Optional parameters

  • selectobject
  • select.procedureCodeobject

    Which of the procedure code's columns to return.

  • select.procedureCode.idboolean

    CPT or HCPCS procedure code (for example 99213).

  • select.procedureCode.shortDescriptionboolean

    Short procedure description resolved from the procedure-code reference data.

  • whereobject
  • where.procedureCodeobject

    Filters on the procedure code's columns.

  • where.procedureCode.idobject | object | object | object | object | object | object | string[]

    CPT or HCPCS procedure code (for example 99213).

  • where.procedureCode.shortDescriptionobject | object | object | object | object | object | object | string[]

    Short procedure description resolved from the procedure-code reference data.

  • aggregateobject
  • aggregate.procedureCodeobject
  • aggregate.procedureCode.countboolean

    When true, return the number of rows that match the filter.

  • aggregate.procedureCode.sumobject

    Numeric columns to total across the rows that match the filter.

  • aggregate.procedureCode.avgobject

    Numeric columns to average across the rows that match the filter.

  • aggregate.procedureCode.minobject

    Numeric columns to find the smallest value of across the rows that match the filter.

  • aggregate.procedureCode.maxobject

    Numeric columns to find the largest value of across the rows that match the filter.

  • orderByobject[]
  • searchstring
  • takeinteger
  • skipinteger

ReturnsTyped browse response for ProcedureCodeBrowseResponse

Conditional attributes

  • tableobject[]
  • table[].procedureCodeobject

    The procedure code's columns, as selected by the request.

  • table[].procedureCode.idstring

    CPT or HCPCS procedure code (for example 99213).

  • table[].procedureCode.shortDescriptionstring

    Short procedure description resolved from the procedure-code reference data.

  • aggregateobject
  • aggregate.procedureCodeobject
  • aggregate.procedureCode.countinteger

    Number of rows that match the filter. Present when `count` was requested.

  • aggregate.procedureCode.sumobject

    Total of each requested numeric column across the rows that match the filter.

  • aggregate.procedureCode.avgobject

    Average of each requested numeric column across the rows that match the filter.

  • aggregate.procedureCode.minobject

    Smallest value of each requested numeric column across the rows that match the filter.

  • aggregate.procedureCode.maxobject

    Largest value of each requested numeric column across the rows that match the filter.

  • totalinteger

Errors

400401500

POST/v0/procedures/browse

Browse procedures

Queries the procedures on the patients visible to the caller. Read-only. Uses the shared browse syntax described in Browsing tables and returns the { table, aggregate, total } envelope as JSON, or the selected columns as CSV when you send Accept: text/csv. Until clinical data has finished loading after a service restart, the call returns 500 rather than an empty table; retry shortly.

Request bodyapplication/json

Optional parameters

  • selectobject
  • select.procedureobject

    Which of the procedure's columns to return.

  • select.procedure.refboolean

    Reference for the procedure record in the current output. It can change when clinical data is reprocessed.

  • select.procedure.lineSequenceboolean

    Sequence number of the procedure line within its source visit or claim.

  • select.procedure.lineItemControlNumberboolean

    Source control or tracking number for the procedure line.

  • select.procedure.revenueCodeboolean

    Revenue code reported for the procedure line. Preserve as text, including leading zeros.

  • select.procedure.modifier1boolean

    First modifier reported for the procedure code. Qualifies the service described by that code.

  • select.procedure.modifier2boolean

    Second modifier reported for the procedure code.

  • select.procedure.modifier3boolean

    Third modifier reported for the procedure code.

  • select.procedure.modifier4boolean

    Fourth modifier reported for the procedure code.

  • select.procedure.unitCountboolean

    Number of service units reported for the procedure line. Units depend on the procedure and source and may be fractional.

  • select.procedure.procedureCodeDescriptionboolean

    Description stored with the procedure when the source data was ingested. It may differ from the current reference-data description.

  • select.procedure.createdAtboolean

    Timestamp associated with the procedure data in the platform. For procedures derived from a merged visit, this is the newest contributing visit-data timestamp.

  • select.procedure.dataSourcesboolean
  • select.procedure.companyIdboolean

    Platform identifier for the customer organization associated with the record.

  • select.procedure.projectIdboolean

    Platform identifier for the project containing the patient and record.

  • select.procedure.patientIdboolean

    Platform identifier for the patient associated with the record. Use with the company and project identifiers to identify the patient scope.

  • select.procedure.visitRefboolean

    Reference to the parent visit in the current clinical output. This reference can change when the data is reprocessed.

  • select.procedure.procedureCodeboolean

    Procedure code reported for the service, such as a CPT or HCPCS code. Preserve as text.

  • select.procedure.attendingProviderIdboolean

    Platform practitioner reference for the attending provider associated with the procedure.

  • select.procedure.renderingProviderIdboolean

    Platform practitioner reference for the rendering provider associated with the procedure.

  • select.procedure.operatingProviderIdboolean

    Platform practitioner reference for the operating provider associated with the procedure.

  • select.procedure.diagnosisCountboolean

    Number of diagnoses linked to this procedure line.

  • select.companyobject & object

    Which of the joined company's columns to return. Absent when the row has no company.

  • select.projectobject & object

    Which of the joined project's columns to return. Absent when the row has no project.

  • select.patientobject & object

    Which of the joined patient's columns to return. Absent when the row has no patient.

  • select.visitobject & object

    Which of the joined visit's columns to return. Absent when the row has no visit.

  • select.procedureCodeobject & object

    Which of the joined procedure code's columns to return. Absent when the row has no procedure code.

  • select.attendingProviderobject & object

    Which of the joined attending provider's columns to return. Absent when the row has no attending provider.

  • select.renderingProviderobject & object

    Which of the joined rendering provider's columns to return. Absent when the row has no rendering provider.

  • select.operatingProviderobject & object

    Which of the joined operating provider's columns to return. Absent when the row has no operating provider.

  • whereobject
  • where.procedureobject

    Filters on the procedure's columns.

  • where.procedure.refobject | object | object | object | object | object | object | string[]

    Reference for the procedure record in the current output. It can change when clinical data is reprocessed.

  • where.procedure.lineSequenceobject | object | object | object | object | object | object | object | string[]

    Sequence number of the procedure line within its source visit or claim.

  • where.procedure.lineItemControlNumberobject | object | object | object | object | object | object | string[]

    Source control or tracking number for the procedure line.

  • where.procedure.revenueCodeobject | object | object | object | object | object | object | string[]

    Revenue code reported for the procedure line. Preserve as text, including leading zeros.

  • where.procedure.modifier1object | object | object | object | object | object | object | string[]

    First modifier reported for the procedure code. Qualifies the service described by that code.

  • where.procedure.modifier2object | object | object | object | object | object | object | string[]

    Second modifier reported for the procedure code.

  • where.procedure.modifier3object | object | object | object | object | object | object | string[]

    Third modifier reported for the procedure code.

  • where.procedure.modifier4object | object | object | object | object | object | object | string[]

    Fourth modifier reported for the procedure code.

  • where.procedure.unitCountobject | object | object | object | object | object | object | object | string[]

    Number of service units reported for the procedure line. Units depend on the procedure and source and may be fractional.

  • where.procedure.procedureCodeDescriptionobject | object | object | object | object | object | object | string[]

    Description stored with the procedure when the source data was ingested. It may differ from the current reference-data description.

  • where.procedure.createdAtobject | object | object | object | object | object | object | object | string[]

    Timestamp associated with the procedure data in the platform. For procedures derived from a merged visit, this is the newest contributing visit-data timestamp.

  • where.procedure.dataSourcesobject | object | object | object | object | object | object | string[]
  • where.procedure.companyIdobject | object | object | object | object | object | object | object | string[]

    Platform identifier for the customer organization associated with the record.

  • where.procedure.projectIdobject | object | object | object | object | object | object | string[]

    Platform identifier for the project containing the patient and record.

  • where.procedure.patientIdobject | object | object | object | object | object | object | string[]

    Platform identifier for the patient associated with the record. Use with the company and project identifiers to identify the patient scope.

  • where.procedure.visitRefobject | object | object | object | object | object | object | string[]

    Reference to the parent visit in the current clinical output. This reference can change when the data is reprocessed.

  • where.procedure.procedureCodeobject | object | object | object | object | object | object | string[]

    Procedure code reported for the service, such as a CPT or HCPCS code. Preserve as text.

  • where.procedure.attendingProviderIdobject | object | object | object | object | object | object | string[]

    Platform practitioner reference for the attending provider associated with the procedure.

  • where.procedure.renderingProviderIdobject | object | object | object | object | object | object | string[]

    Platform practitioner reference for the rendering provider associated with the procedure.

  • where.procedure.operatingProviderIdobject | object | object | object | object | object | object | string[]

    Platform practitioner reference for the operating provider associated with the procedure.

  • where.procedure.diagnosisCountobject | object | object | object | object | object | object | object | string[]

    Number of diagnoses linked to this procedure line.

  • where.companystring | object & object

    Filters on the joined company's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a company.

  • where.projectstring | object & object

    Filters on the joined project's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a project.

  • where.patientstring | object & object

    Filters on the joined patient's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a patient.

  • where.visitstring | object & object

    Filters on the joined visit's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a visit.

  • where.procedureCodestring | object & object

    Filters on the joined procedure code's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a procedure code.

  • where.attendingProviderstring | object & object

    Filters on the joined attending provider's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a attending provider.

  • where.renderingProviderstring | object & object

    Filters on the joined rendering provider's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a rendering provider.

  • where.operatingProviderstring | object & object

    Filters on the joined operating provider's columns. `isNull` or `isNotNull` in place of the filters matches the rows without or with a operating provider.

  • aggregateobject
  • aggregate.procedureobject
  • aggregate.procedure.countboolean

    When true, return the number of rows that match the filter.

  • aggregate.procedure.sumobject

    Numeric columns to total across the rows that match the filter.

  • aggregate.procedure.avgobject

    Numeric columns to average across the rows that match the filter.

  • aggregate.procedure.minobject

    Numeric columns to find the smallest value of across the rows that match the filter.

  • aggregate.procedure.maxobject

    Numeric columns to find the largest value of across the rows that match the filter.

  • aggregate.companyobject & object
  • aggregate.projectobject & object
  • aggregate.patientobject & object
  • aggregate.visitobject & object
  • aggregate.procedureCodeobject & object
  • aggregate.attendingProviderobject & object
  • aggregate.renderingProviderobject & object
  • aggregate.operatingProviderobject & object
  • orderByobject | object | object | object | object | object | object | object | object[]
  • searchstring
  • takeinteger
  • skipinteger

ReturnsTyped browse response for ProcedureBrowseResponse

Conditional attributes

  • tableobject[]
  • table[].procedureobject & object

    The procedure's columns, as selected by the request.

  • table[].companyobject & object & object & object

    The joined company's columns, as selected by the request. Absent when the row has no company.

  • table[].projectobject & object & object

    The joined project's columns, as selected by the request. Absent when the row has no project.

  • table[].patientobject & object & object

    The joined patient's columns, as selected by the request. Absent when the row has no patient.

  • table[].visitobject & object & object

    The joined visit's columns, as selected by the request. Absent when the row has no visit.

  • table[].procedureCodeobject & object

    The joined procedure code's columns, as selected by the request. Absent when the row has no procedure code.

  • table[].attendingProviderobject & object

    The joined attending provider's columns, as selected by the request. Absent when the row has no attending provider.

  • table[].renderingProviderobject & object

    The joined rendering provider's columns, as selected by the request. Absent when the row has no rendering provider.

  • table[].operatingProviderobject & object

    The joined operating provider's columns, as selected by the request. Absent when the row has no operating provider.

  • aggregateobject
  • aggregate.procedureobject
  • aggregate.procedure.countinteger

    Number of rows that match the filter. Present when `count` was requested.

  • aggregate.procedure.sumobject

    Total of each requested numeric column across the rows that match the filter.

  • aggregate.procedure.avgobject

    Average of each requested numeric column across the rows that match the filter.

  • aggregate.procedure.minobject

    Smallest value of each requested numeric column across the rows that match the filter.

  • aggregate.procedure.maxobject

    Largest value of each requested numeric column across the rows that match the filter.

  • aggregate.companyobject & object
  • aggregate.projectobject & object
  • aggregate.patientobject & object
  • aggregate.visitobject & object
  • aggregate.procedureCodeobject & object
  • aggregate.attendingProviderobject & object
  • aggregate.renderingProviderobject & object
  • aggregate.operatingProviderobject & object
  • totalinteger

Errors

400401500