Skip to content
RoxyAPI
Get API Key

Angel Numbers API reference

Angel numbers API with meanings for 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, and 75+ sequences covering every common family. Each reading breaks down into spiritual, love, career, money, and twin flame guidance, plus a biblical perspective and an honest shadow reading. Smart lookup analyzes any number sequence with pattern detection, digit-root calculation, classification, and an optional sighting-context note. Daily angel number endpoint, and filter by type (repeating, sequential, mirror, master, compound). Built for synchronicity apps, spiritual journals, daily guidance features, AI chatbots, and wellness platforms. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

4 endpoints. Product page. Typed SDKs in six languages carry every operation below.

Kept in this tab only. Without a key, a small daily allowance still answers every request below.

List all angel numbers - Angel number catalog API

GET /api/v2/angel-numbers/numbers

Retrieve the angel number catalog with summary information. Returns 75+ angel numbers covering root digits (0-9), master numbers (11, 22, 33), double digits (44-99), triple repeating (111-999), quad repeating (1111-9999), the mirror families (X0X like 101-909, X1X, four-digit mirrors like 1212-2121), palindromes (1221, 1331), compound sequences (911, 1122), and sequential numbers (123, 1234). Supports optional type filtering. Perfect for building angel number explorer apps, reference guides, and spiritual databases.

Parameters

ParameterTypeDescription
lang querystring enumResponse language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en.
limit queryintegerMaximum items to return per page. Range: 1-50, default 20. Default 20.
offset queryintegerNumber of items to skip for pagination. Default 0. Default 0.
type querystring enumFilter results by angel number pattern type. "repeating" returns numbers like 111, 444, 7777. "sequential" returns patterns like 1234. "mirror" returns palindrome or alternating patterns like 1212, 717. "master" returns 11, 22, 33. "root" returns single digits 0-9. "compound" returns mixed sequences with no pure pattern like 911, 1122.
curl
curl "https://roxyapi.com/api/v2/angel-numbers/numbers" \
  -H "X-API-Key: YOUR_KEY"

Response fields

FieldTypeDescription
total requirednumberTotal number of angel numbers matching the applied filters. The full catalog size when unfiltered, fewer when filtered by type.
limit requirednumberMaximum items returned per page.
offset requirednumberNumber of items skipped from the start of the result set.
numbers requiredarray of objectArray of angel number summaries for the current page.
numbers[].number requiredstringAngel number sequence as a string. Common patterns include triple repeating (111-999), quad repeating (1111-9999), master numbers (11, 22, 33), mirror patterns (1212), and sequential numbers (1234).
numbers[].title requiredstringShort descriptive title capturing the core theme and spiritual significance of this angel number.
numbers[].coreMessage requiredstringOne to two sentence summary of the divine message. Ideal for push notifications, daily guidance widgets, and quick reference lookups.
numbers[].type requiredstringPattern classification of the angel number. "repeating" means all digits are the same (111, 4444). "sequential" means consecutive digits (1234). "mirror" means palindrome or alternating pattern (1212, 1221). "master" means numerology master number (11, 22, 33). "root" means single digit (0-9). "compound" means a mixed sequence with no pure pattern (911, 1122).
numbers[].digitRoot requirednumberNumerology digit root calculated by summing all digits and reducing to a single digit. Links each angel number to foundational numerology meaning. Master numbers 11, 22, 33 are preserved without further reduction.
numbers[].keywords requiredarray of stringFive to eight keywords capturing the spiritual themes and energy of this angel number. Useful for search, filtering, and content generation.
numbers[].energy requiredstringOverall energy classification. "positive" indicates encouraging, uplifting energy. "neutral" indicates transitional energy (neither purely positive nor cautionary). "cautionary" indicates a gentle warning to rebalance or pay attention.
Example response
{
  "total": 78,
  "limit": 20,
  "offset": 0,
  "numbers": [
    {
      "number": "111",
      "title": "New Beginnings, Manifestation, and Alignment With Your Highest Purpose",
      "coreMessage": "Your focus is shaping what comes next. Give your attention to what you want rather than what you fear, because a new chapter is beginning.",
      "type": "repeating",
      "digitRoot": 3,
      "keywords": [
        "new beginnings",
        "manifestation"
      ],
      "energy": "positive"
    }
  ]
}

Try it

Not sent

Get angel number meaning - Angel number lookup API

GET /api/v2/angel-numbers/numbers/{number}

Get the full meaning and interpretation for a specific angel number. Returns detailed spiritual, love, career, money, and twin flame interpretations, plus a biblical perspective and a shadow reading, along with keywords, affirmation, and actionable steps. Covers 75+ angel numbers including 111, 222, 333, 444, 555, 666, 777, 888, 999, 1111, 1212, 1234, and more, across every major angel number pattern.

Parameters

ParameterTypeDescription
number required pathstringAngel number sequence to look up (e.g., "111", "444", "1212", "1234"). Must match an entry in the database.
lang querystring enumResponse language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en.
curl
curl "https://roxyapi.com/api/v2/angel-numbers/numbers/444" \
  -H "X-API-Key: YOUR_KEY"

Response fields

FieldTypeDescription
number requiredstringAngel number sequence as a string. Common patterns include triple repeating (111-999), quad repeating (1111-9999), master numbers (11, 22, 33), mirror patterns (1212), and sequential numbers (1234).
title requiredstringShort descriptive title capturing the core theme and spiritual significance of this angel number.
coreMessage requiredstringOne to two sentence summary of the divine message. Ideal for push notifications, daily guidance widgets, and quick reference lookups.
type requiredstringPattern classification of the angel number. "repeating" means all digits are the same (111, 4444). "sequential" means consecutive digits (1234). "mirror" means palindrome or alternating pattern (1212, 1221). "master" means numerology master number (11, 22, 33). "root" means single digit (0-9). "compound" means a mixed sequence with no pure pattern (911, 1122).
digitRoot requirednumberNumerology digit root calculated by summing all digits and reducing to a single digit. Links each angel number to foundational numerology meaning. Master numbers 11, 22, 33 are preserved without further reduction.
keywords requiredarray of stringFive to eight keywords capturing the spiritual themes and energy of this angel number. Useful for search, filtering, and content generation.
energy requiredstringOverall energy classification. "positive" indicates encouraging, uplifting energy. "neutral" indicates transitional energy (neither purely positive nor cautionary). "cautionary" indicates a gentle warning to rebalance or pay attention.
meaning requiredobject
meaning.spiritual requiredstringTwo to three paragraph spiritual interpretation covering divine guidance, higher purpose, and the metaphysical significance of this angel number sequence.
meaning.love requiredstringLove and relationship interpretation covering singles, couples, and those healing from past relationships. Includes romantic guidance and partnership advice.
meaning.career requiredstringCareer and vocation guidance: professional opportunities, calling, and practical work advice aligned with this angel number energy. Money and finances are returned separately in the money field.
meaning.money requiredstringMoney, finances, and material abundance guidance, kept distinct from career and vocation. Covers income, spending, debt, and prosperity mindset for this angel number.
meaning.twinFlame requiredstringTwin flame connection interpretation covering union, separation, and spiritual growth within the twin flame journey.
biblical requiredstringBiblical and religious perspective on the sequence, framed honestly. States plainly when a number is not a scriptural concept rather than inventing scripture.
Show all fieldsShow fewer fields
FieldTypeDescription
shadow requiredstringShadow or cautionary reading: the misuse, over-reliance, or imbalance this sequence can signal. Complements the energy classification.
affirmation requiredstringPositive affirmation aligned with this angel number. Can be used for daily affirmation features, meditation guidance, or spiritual journal prompts.
actionSteps requiredarray of stringThree to five specific, actionable steps to take when you see this angel number. Practical spiritual guidance for daily life.
Example response
{
  "number": "111",
  "title": "New Beginnings, Manifestation, and Alignment With Your Highest Purpose",
  "coreMessage": "Your focus is shaping what comes next. Give your attention to what you want rather than what you fear, because a new chapter is beginning.",
  "type": "repeating",
  "digitRoot": 3,
  "keywords": [
    "new beginnings",
    "manifestation"
  ],
  "energy": "positive",
  "meaning": {
    "spiritual": "Angel number 111 is one of the strongest manifestation signals in the angelic system. When it appears, the energy around you is ripe for new beginnings, and what you hold in your attention tends to take form more readily than usual.",
    "love": "In love, 111 marks fresh starts and new possibility. For those who are single, it suggests that a meaningful connection may be forming, but it asks you first to align your own thoughts with the kind of love you want to receive.",
    "career": "Professionally, 111 points to new opportunities taking shape. This is a favorable moment to start the venture, apply for the role, or launch the project you have been weighing, because your initiative carries extra momentum now.",
    "money": "In money matters, 111 favors fresh starts. It is a supportive moment to open a new income stream, reset a budget, or change a financial habit, because the patterns you set now tend to take hold.",
    "twinFlame": "For twin flames, 111 is a significant marker of either an approaching meeting or a clear step forward on the journey. If you have not yet met, 111 suggests that a meeting is drawing nearer."
  },
  "biblical": "In the Bible the number 1 speaks of unity and primacy, the truth that God is one (Deuteronomy 6:4), and of beginnings. Angel numbers as personal codes are not a biblical concept, and Scripture does not single out 111.",
  "shadow": "The shadow side of 111 is mistaking thought for action. The same focus that manifests can curdle into magical thinking, the belief that wanting something hard enough replaces the work of building it.",
  "affirmation": "My focus shapes my reality, so I give my attention to what I want to create.",
  "actionSteps": [
    "Notice where your thoughts have been pointing, since they are taking form",
    "Set one clear, positive intention for what you want to begin"
  ]
}

Try it

Not sent

Analyze any number sequence - Angel number analysis API

GET /api/v2/angel-numbers/lookup

Smart angel number analysis that works for ANY number sequence, not just known angel numbers. Automatically classifies the pattern type (repeating, sequential, mirror, master, root, compound), calculates the numerology digit root, checks the database for a known meaning, and provides the foundational digit root interpretation (with full spiritual, love, career, money, and twin flame guidance) as a fallback. An optional context parameter adds a note tailored to where the number was seen. Perfect for synchronicity tracking apps where users enter arbitrary number sequences they encounter.

Parameters

ParameterTypeDescription
lang querystring enumResponse language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en.
number required querystringNumber sequence to analyze (1-8 digits). Can be any number the user has encountered: clock times (1111), addresses (717), receipts (888), license plates (4444), or any repeating pattern.
context querystring enumWhere the number was seen. When supplied, the response adds a contextNote tailoring the reading to the sighting: clock (a glanced time), receipt (a purchase), license-plate (in transit), phone (a call or notification), address (a home or place), price (a total or amount).
curl
curl "https://roxyapi.com/api/v2/angel-numbers/lookup?number=1234" \
  -H "X-API-Key: YOUR_KEY"

Response fields

FieldTypeDescription
number requiredstringThe number sequence that was analyzed.
type requiredstringPattern classification detected for this number. "repeating" means all same digits. "sequential" means consecutive ascending or descending. "mirror" means palindrome or alternating pattern. "master" means numerology master number. "root" means single digit. "compound" means a multi-digit sequence with no pure pattern (e.g. 911, 1122).
digitRoot requirednumberNumerology digit root from summing and reducing all digits. Links to foundational single-digit meaning. Master numbers 11, 22, 33 are preserved.
digits requirednumberTotal number of digits in the sequence.
uniqueDigits requirednumberCount of unique digits. A repeating number like 111 has 1 unique digit; 1234 has 4.
isPalindrome requiredbooleanWhether the number reads the same forwards and backwards (e.g., 1221, 1001).
isRepeating requiredbooleanWhether all digits are identical (e.g., 111, 4444, 777).
knownMeaning requiredobjectnullFull angel number meaning if this number exists in the curated database (75+ known sequences). Null if the number is not in the database, in which case use the analysis fields (type, digitRoot) and the digitRootMeaning fallback for interpretation.
knownMeaning.title requiredstringTitle of the matched angel number meaning.
knownMeaning.coreMessage requiredstringCore message summary.
knownMeaning.energy requiredstringEnergy classification (positive, neutral, cautionary).
knownMeaning.keywords requiredarray of stringKeywords for this angel number.
knownMeaning.meaning requiredobjectDetailed interpretations across life areas.
knownMeaning.meaning.spiritual requiredstringSpiritual interpretation covering divine guidance, higher purpose, and metaphysical significance.
Show all fieldsShow fewer fields
FieldTypeDescription
knownMeaning.meaning.love requiredstringLove and relationship interpretation for singles, couples, and those healing from past relationships.
knownMeaning.meaning.career requiredstringCareer and vocation guidance. Money and finances are returned separately in the money field.
knownMeaning.meaning.money requiredstringMoney, finances, and material abundance guidance, distinct from career.
knownMeaning.meaning.twinFlame requiredstringTwin flame connection interpretation covering union, separation, and spiritual growth.
knownMeaning.biblical requiredstringBiblical and religious perspective, framed honestly.
knownMeaning.shadow requiredstringShadow or cautionary reading for this number.
knownMeaning.affirmation requiredstringPositive affirmation for this number.
knownMeaning.actionSteps requiredarray of stringActionable steps when you see this number.
digitRootMeaning requiredobjectnullThe foundational meaning of this number based on its digit root. Every number reduces to a root digit (0-9) or master number (11, 22, 33), which provides the base interpretation even for unknown sequences.
digitRootMeaning.number requiredstringRoot digit number (0-9) or master number (11, 22, 33).
digitRootMeaning.title requiredstringTitle of the root digit meaning in numerology.
digitRootMeaning.coreMessage requiredstringCore message of the foundational root digit.
digitRootMeaning.meaning requiredobjectFull life-area interpretation of the underlying root digit. For an unknown sequence this is the substantive reading to display, so a synchronicity app never dead-ends on an arbitrary number.
digitRootMeaning.meaning.spiritual requiredstringSpiritual interpretation of the root digit, covering divine guidance, higher purpose, and metaphysical significance.
digitRootMeaning.meaning.love requiredstringLove and relationship interpretation of the root digit, for singles, couples, and those healing from past relationships.
digitRootMeaning.meaning.career requiredstringCareer and vocation guidance for the root digit. Money and finances are returned separately in the money field.
digitRootMeaning.meaning.money requiredstringMoney, finances, and material abundance guidance for the root digit, kept distinct from career.
digitRootMeaning.meaning.twinFlame requiredstringTwin flame interpretation of the root digit, covering union, separation, and spiritual growth.
digitRootMeaning.keywords requiredarray of stringKeywords for the root digit.
digitRootMeaning.affirmation requiredstringAffirmation for the root digit.
contextNotestringPresent only when the context query parameter is supplied. A short reading layered on top of the meaning that accounts for WHERE the number was seen (clock, receipt, license plate, phone, address, price), since the place of a sighting shifts its emphasis.
Example response
{
  "number": "1234",
  "type": "sequential",
  "digitRoot": 1,
  "digits": 4,
  "uniqueDigits": 4,
  "isPalindrome": false,
  "isRepeating": false,
  "contextNote": "Catching 1234 on a clock is the most common way this sequence reaches you. Treat the moment you glanced up as a timestamp on whatever you were just thinking or feeling, and read the meaning below against that exact thought."
}

Try it

Not sent

Daily angel number - Angel number of the day API

POST /api/v2/angel-numbers/daily

Get the angel number of the day with full meaning and interpretation. Returns a deterministic angel number based on the current date (or a provided seed date), ensuring all users see the same number for any given day. Includes complete spiritual, love, career, money, and twin flame interpretations plus a biblical perspective and a shadow reading. Perfect for daily guidance features, push notifications, content generation, and angel number widget integrations.

Parameters

ParameterTypeDescription
lang querystring enumResponse language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en.

Request body

FieldTypeDescription
seedstringOptional seed for reproducible readings. Same seed + same date = same angel number every time. Pass any unique identifier (userId, email hash, session token). Omit for anonymous daily readings.
datestring (date)Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones.
curl
curl -X POST "https://roxyapi.com/api/v2/angel-numbers/daily" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"user123","date":"2026-03-06"}'

Response fields

FieldTypeDescription
date requiredstringThe date used for angel number selection (UTC).
seed requiredstringComputed seed used for this reading. Same seed always produces the same angel number.
number requiredstringAngel number sequence selected for today. Three or more digit repeating, sequential, or mirror pattern (e.g., 111, 444, 1212).
title requiredstringShort descriptive title capturing the core theme and spiritual significance of the daily angel number.
coreMessage requiredstringOne to two sentence summary of the divine message for today. Ideal for push notifications, daily guidance widgets, and quick reference.
type requiredstringPattern classification of the daily angel number. "repeating" means all digits are the same (111, 4444). "sequential" means consecutive digits (1234). "mirror" means palindrome or alternating pattern (1212, 1221).
digitRoot requirednumberNumerology digit root calculated by summing all digits and reducing to a single digit. Links the daily angel number to its foundational numerology meaning.
energy requiredstringOverall energy classification. "positive" indicates encouraging, uplifting energy. "neutral" indicates transitional energy. "cautionary" indicates a gentle warning to rebalance or pay attention.
meaning requiredobjectDetailed interpretations across life areas for the daily angel number.
meaning.spiritual requiredstringTwo to three paragraph spiritual interpretation covering divine guidance, higher purpose, and the metaphysical significance of the angel number selected for this date.
meaning.love requiredstringLove and relationship interpretation covering singles, couples, and those healing from past relationships. Includes romantic guidance and partnership advice.
meaning.career requiredstringCareer and vocation guidance: professional opportunities, calling, and practical work advice. Money and finances are returned separately in the money field.
meaning.money requiredstringMoney, finances, and material abundance guidance, kept distinct from career and vocation.
meaning.twinFlame requiredstringTwin flame connection interpretation covering union, separation, and spiritual growth within the twin flame journey.
Show all fieldsShow fewer fields
FieldTypeDescription
biblical requiredstringBiblical and religious perspective on the daily sequence, framed honestly.
shadow requiredstringShadow or cautionary reading for the daily sequence. Complements the energy classification.
keywords requiredarray of stringFive to eight keywords capturing the spiritual themes and energy of the daily angel number. Useful for search, filtering, and content generation.
affirmation requiredstringPositive affirmation aligned with the daily angel number. Use for daily affirmation features, meditation guidance, or spiritual journal prompts.
actionSteps requiredarray of stringThree to five specific, actionable steps to take today based on the angel number guidance. Practical spiritual advice for daily life.
Example response
{
  "date": "2026-03-05",
  "seed": "user123-2026-03-05",
  "number": "444",
  "title": "Angelic Protection, Solid Foundations, and the Signal to Keep Going",
  "coreMessage": "You are protected and supported. Keep building on the foundations you have laid, because steady effort is moving you toward solid ground.",
  "type": "repeating",
  "digitRoot": 3,
  "energy": "positive",
  "meaning": {
    "spiritual": "Among the angel numbers, 444 is the one most closely associated with the presence of angels themselves. It is a sign of being supported and watched over, particularly during a stretch that has tested your sense of security.",
    "love": "In love, 444 points to foundations rather than fireworks. It favors trust, honesty, loyalty, and consistency, the quiet structural elements that let a relationship last.",
    "career": "Professionally, 444 reads as permission to move forward from a base you have already built. Progress here comes from consistency and attention to detail rather than dramatic leaps.",
    "money": "In money matters, 444 speaks to stability that is built rather than wished for. It signals that financial security is within reach, but reached through patience, discipline, and sound decisions rather than a sudden windfall.",
    "twinFlame": "For twin flames, 444 indicates support around the connection, even through a phase of separation. It suggests that both people are being guided toward the stability a lasting union requires, which makes the real work individual."
  },
  "biblical": "In the Bible the number 4 is tied to creation and earthly order: the fourth day, when the sun, moon, and stars were set in place, and figures such as the four corners of the earth and the four winds. Angel numbers as personal codes are not a biblical concept, and Scripture does not single out 444.",
  "shadow": "The shadow side of 444 is structure turned rigid. The same drive that builds stability can harden into stubbornness, resistance to change, or a refusal to let chance and spontaneity in.",
  "keywords": [
    "protection",
    "foundation"
  ],
  "affirmation": "I am supported and protected, and the foundations I am building will hold.",
  "actionSteps": [
    "Trust that you are supported, and keep building rather than restarting",
    "Strengthen one practical foundation this week, whether finances, health, or home"
  ]
}

Try it

JSON, as the example above shows it.
Not sent