List features
GET /api/v3/features
The request and response builder is not available for this endpoint. See the OpenAPI specification for complete parameters and schemas.
Fields
Choose fields to return, filter, or sort. Expand a field for examples and associated fields. Collections can only be returned on the top-level resource, not inside an associated resource.
| Field | Type | Returned by default | Sortable | Supported filters |
|---|---|---|---|---|
Unique record ID. | integer | Yes | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
URL to view the record in Aha! | string | Yes | No | None |
Return this field: | ||||
API URL for the record. | string | Yes | No | None |
Return this field: | ||||
Name of the record. | string | Yes | Yes | eqnot_eqcontainsstarts_withinnot_inemptynot_empty |
Return this field: Filter example: Sort: | ||||
Reference number of the record. | string | Yes | Yes | eqnot_eqcontainsstarts_withinnot_inemptynot_empty |
Return this field: Filter example: Sort: | ||||
Date and time when the record was created. | date-time | No | Yes | eqgtgteltltebetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Date and time when the record was last updated. | date-time | No | Yes | eqgtgteltltebetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Start date of the record. | date | No | Yes | eqgtgteltltebetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
End date of the record. | date | No | Yes | eqgtgteltltebetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Progress completed for the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Score assigned to the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Initial work estimate for the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Detailed work estimate for the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Remaining work estimate for the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Work completed for the record. | number | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
Position of the record relative to its siblings. | integer | No | Yes | eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty |
Return this field: Filter example: Sort: | ||||
How progress is calculated for the record. | string | No | No | eqnot_eqinnot_inemptynot_empty |
Return this field: Allowed values: Filter example: | ||||
How start and end dates are calculated for the record. | string | No | No | None |
Return this field: Allowed values: | ||||
Whether estimates are entered on the record or calculated from its requirements. | string | No | Yes | eqnot_eqinnot_inemptynot_empty |
Return this field: Allowed values: Filter example: Sort: | ||||
Epic associated with the feature. | Epic | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Status assigned to the record. | Status | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Type assigned to the record. | WorkflowKind | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
User assigned to the record. | AssignedToUser | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
User who created the record. | User | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
HTML description of the record. | Note | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Workspace that contains the record. | Project | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Release associated with the record. | Release | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Release phase associated with the record. | ReleasePhase | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Iteration associated with the record. | Iteration | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Initiative associated with the record. | Initiative | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Team assigned to the record. Availability depends on account settings. | Project | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Team status assigned to the record. Availability depends on account settings. | Status | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Program increment associated with the record. | ProgramIncrement | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Time code assigned to the record. Only available when timesheets are enabled for the account. Availability depends on account settings. | TimeCode | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Tags associated with the feature. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=tags[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Requirements associated with the record. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=requirements[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Goals associated with the feature. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=goals[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Key results associated with the feature. Only available when key results are enabled for the account. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=key_results[default]). Capped at 25 records. Only available on the top-level resource. Availability depends on account settings. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Individual metric values for the feature's scorecards. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=score_facts[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Users watching the record for update notifications. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=watchers[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Internal comments on the record. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=comments[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | emptynot_empty |
Return this field: Filter example: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Custom field values. Property names are custom field definition keys, and each value is one of the supported formats below, depending on the field type. Omitted unless requested with the fields parameter or submitted in the request. Fields with no stored value are omitted. | object | No | No | By custom field type |
Return this field: Custom field keys depend on your account. Request Filter with
Other custom field types cannot be filtered. Custom fields cannot be sorted. | ||||
Status intervals for the record. Use started_at to identify when it entered a status. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=workflow_status_times[default]). Capped at 25 records. Only available on the top-level resource. | Collection | No | No | None |
Return this field: Association filters apply to this field itself. Expand its subfields below to see their individual capabilities. Select subfields with | ||||
Search matches the start of a field path and includes matching associations’ subfields. Use a dotted path to search within a specific association.
Query syntax
Return selected fields with a comma-separated fields parameter, or add a field to the defaults with fields=default,{field}. Expand an association above for its supported subfields and selection examples.
Filter with filter.{operator}[{field}]=value. Multiple filters combine with AND. Use comma-separated values for in and not_in, two inclusive bounds for between, and true for empty and not_empty.
Sort with sort.asc={field} or sort.desc={field}. Explicit sorting limits results to 1,000 records. Omit sorting to retrieve all results in descending ID order.
Set the page size with per_page. Follow pagination.next_url while pagination.has_more is true.
Filter operators
eq equals; not_eq does not equal; contains contains text; starts_with starts with text (both case-insensitive).
gt greater than; gte greater than or equal; lt less than; lte less than or equal.
in matches any listed value; not_in excludes listed values; between matches an inclusive range; empty and not_empty check for an absent or present value.
See field selection, filtering, and pagination and sorting limits for details.