List iterations

GET /api/v3/iterations

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.

FieldTypeReturned by defaultSortableSupported filters

Unique record ID.

integerYesYes
eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty

URL to view the record in Aha!

stringYesNoNone

API URL for the record.

stringYesNoNone

Name of the record.

stringYesYes
eqnot_eqcontainsstarts_withinnot_inemptynot_empty

Reference number of the record.

stringYesYes
eqnot_eqcontainsstarts_withinnot_inemptynot_empty

Date and time when the record was created.

date-timeNoYes
eqgtgteltltebetweenemptynot_empty

Date and time when the record was last updated.

date-timeNoYes
eqgtgteltltebetweenemptynot_empty

Status of the iteration.

stringNoYes
eqnot_eqinnot_inemptynot_empty

Start date of the record.

dateNoYes
eqgtgteltltebetweenemptynot_empty

End date of the record.

dateNoNoNone

Duration of the iteration.

integerNoYes
eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty

Goal of the iteration.

stringNoYes
eqnot_eqcontainsstarts_withinnot_inemptynot_empty

Progress completed for the record.

numberNoYes
eqnot_eqgtgteltlteinnot_inbetweenemptynot_empty

HTML description of the record.

NoteNoNo
emptynot_empty

Workspace that contains the record.

ProjectNoNo
emptynot_empty

Features associated with the iteration. Omitted by default. Request the field for inline records with default sub-fields, or choose sub-fields (e.g., ?fields=features[default]). Capped at 25 records. Only available on the top-level resource.

CollectionNoNo
emptynot_empty

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.

CollectionNoNo
emptynot_empty

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.

CollectionNoNo
emptynot_empty

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.

© 2026 Aha! Labs Inc. • All rights reserved