Skip to main content
GET
/
goals
cURL
curl --request GET \
  --url https://api.yoshi.ai/v1/goals \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "goals": [
      {
        "id": "<string>",
        "name": "<string>",
        "goal_type": "<string>",
        "status": "<string>",
        "target_amount": 123,
        "current_value": 123,
        "target_date": "2023-12-25"
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Authorizations

Authorization
string
header
default:yoshi_test_...
required

A Yoshi API key from Settings → API Keys, or a Yoshi OAuth access token issued by Sign in with Yoshi.

Query Parameters

status
enum<string>
Available options:
active,
paused,
completed,
cancelled

Response

200 - application/json

Goals retrieved.

data
object
required
meta
object
required
Last modified on June 18, 2026