Get all Dreams in a paginated listing.
Get all Dreams in a paginated listing.
Query Parameters
- page integer
Possible values:
>= 1
Default value:
1
The page number in a paginated listing.
- items integer
Possible values:
>= 1
and<= 20
Default value:
20
The number of items to return on each page.
- state string
Possible values: [
active
,deleted
]Filter dreams based on their state
Example: deleted - showImageUrl boolean
Possible values: [
true
,false
]Return Image URL in response if set true
Example: true - showActiveSavehacks boolean
Possible values: [
true
,false
]Return Number of active savehacks in response if set true
Example: true - userId uuid
Filter dreams to only include those with a
userId
equal to the supplieduserId
.Example: 844830a8-b845-4cbc-b79f-865cd8c8aa8e - externalUserId uuid
Filter dreams to only include those with a
externalUserId
equal to the suppliedexternalUserId
.Example: 844830a8-b845-4cbc-b79f-865cd8c8aa8e
- 200
All non-deleted Dreams in a paginated listing.
- application/json
- Schema
- Example (from schema)
Schema
dreams object[]
Array [id uuidtargetCents integerRepresents how much money (in cents or the smallest currency subunit) the User wants to save to complete this Dream.
type stringexpiresAt object(Optional) Date before which the User wants to complete this Dream.
achievedAt objectRepresents when the dream was completed
name stringbalanceCents integerCurrent balance cents for dream
deletedAt objectRepresents when the dream was deleted
imageUrl stringactiveSavehacksCount integerCurrent count of active savehacks
user object
type string requiredid string requiredexternalId stringgroupDream object
(Optional) GroupDream this Dream is a part of.
type string requiredid string requiredaccount object
Identifies the account where all money towards this dream is stored
type string requiredid string requiredexternalId string]meta object
next_url urlURL for the next page.
count integerThe total count of items.
items integerThe number of returned items on this page.
pages integerThe number of pages.
from integerIndex of the first item on this page (starting from 1).
to integerIndex of the last item on this page.
{
"dreams": [
{
"id": "844830a8-b845-4cbc-b79f-865cd8c8aa8e",
"targetCents": 102000,
"type": "Dream",
"expiresAt": "2006-01-02",
"achievedAt": "2006-01-02T15:04:05Z",
"name": "Trip to Japan",
"balanceCents": 12300,
"deletedAt": "2006-01-02T15:04:05Z",
"imageUrl": "https://images.com/photo-123-456",
"activeSavehacksCount": 2,
"user": {
"type": "string",
"id": "string",
"externalId": "string"
},
"groupDream": {
"type": "string",
"id": "string"
},
"account": {
"type": "string",
"id": "string",
"externalId": "string"
}
}
],
"meta": true
}