GET/v1/numerology/angel/today

Today's angel number

Compute today's angel number from the current date. The date's digits are summed and reduced to a single digit (1-9), then the triple sequence of that digit is returned (e.g. digit 3 → angel number 333). The same number is returned for all callers on the same date. "Today" is the current date in UTC unless you pass timezone (the caller's IANA zone, e.g. Asia/Kolkata) or an explicit date.

Request parameters

dateoptional

string | null

Date in YYYY-MM-DD format to compute the number for. Overrides timezone.

timezoneoptional

string | null

IANA time zone (or ±HH:MM) whose current date is "today", e.g. Asia/Kolkata. Default: UTC.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.number

string

Angel number sequence, e.g. '111', '1111'.

data.theme

string

Core theme of this angel number.

data.message

string

Primary message of this angel number.

data.guidance

string

Actionable guidance for this number.

data.areas

array[string]

Life areas associated with this number.

data.date

string

Date for which this number was computed (YYYY-MM-DD).

data.daily_digit

integer

Reduced single digit from today's date (1-9).

data.angel_number

string

The angel number sequence derived from today's date.

data.timezone

string | null

Time zone whose current date was taken as today: the timezone you passed, or 'UTC'. Absent when you passed an explicit date.

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

resource_not_found

The requested resource was not found at this endpoint. Verify the URL path and resource identifier.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Angel number meaning
• List supported angel numbers
• Personal angel number

Request

GET·application/json

curl

curl -X GET "https://api.asterwise.com/v1/numerology/angel/today" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.angel_today()
    print(result)

TypeScript

import { createClient, createConfig, angelToday } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await angelToday({
  client,
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "date": "2026-10-08",
    "daily_digit": 1,
    "angel_number": "111",
    "number": "111",
    "theme": "Manifestation, new beginnings",
    "message": "Your thoughts are manifesting rapidly. Be intentional — what you focus on now becomes reality. Plant seeds deliberately.",
    "guidance": "Monitor your thoughts closely. Shift any negative mental loops immediately. You are a powerful creator right now.",
    "areas": [
      "Manifestation",
      "Thoughts",
      "... and 2 more items"
    ],
    "timezone": "UTC"
  }
}