Endpoint
POST https://requiems.xyz/v1/entertainment/horoscope/batch
Batch Daily Horoscopes
Returns up to 12 daily horoscopes in a single request.
Parameters
| Name |
Type |
Required |
Location |
Description |
signs |
array |
yes |
body |
Array of signs to get (min: 1, max: 12). Allowed values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. |
Request Example
{
"signs": ["taurus","cancer","libra"]
}
Response Example
{
"data": {
"results": [
{
"sign": "taurus",
"date": "2026-05-21",
"horoscope": "Your patience will be rewarded. Take time to reflect before making important decisions today.",
"lucky_number": 26,
"mood": "reflective"
},
{
"sign": "cancer",
"date": "2026-05-21",
"horoscope": "Your patience will be rewarded. Take time to reflect before making important decisions today.",
"lucky_number": 2,
"mood": "reflective"
},
{
"sign": "libra",
"date": "2026-05-21",
"horoscope": "Rest and self-care are essential today. Taking care of yourself enables you to take care of others.",
"lucky_number": 82,
"mood": "peaceful"
}
],
"total": 3
},
"metadata": {
"timestamp": "2026-05-21T04:09:20Z"
}
}
Response Fields
| Field |
Type |
Description |
results |
array |
List of daily horoscopes returned in the same order as the input signs. |
results[].sign |
string |
Zodiac sign the horoscope corresponds to. |
results[].date |
string |
Date the horoscope is for, in YYYY-MM-DD format. |
results[].horoscope |
string |
Daily horoscope reading for the given sign. |
results[].lucky_number |
integer |
Lucky number for the given sign on that date. |
results[].mood |
string |
Predicted mood for the given sign on that date. |
total |
integer |
Total number of horoscopes returned. |
Errors
422 validation_failed — The signs array is missing, empty, or contains more than 12 items, or includes unsupported sign values.400 bad_request — Invalid JSON, malformed request body, or unexpected field types.
1---
2name: horoscope-post-batch
3api: Horoscope
4method: POST
5path: /v1/entertainment/horoscope/batch
6base_url: https://requiems.xyz
7description: Returns up to 12 daily horoscopes in a single request.
8---
9
10## Endpoint
11
12**POST https://requiems.xyz/v1/entertainment/horoscope/batch**
13
14## Batch Daily Horoscopes
15
16Returns up to 12 daily horoscopes in a single request.
17
18## Parameters
19
20| Name | Type | Required | Location | Description |
21| ---- | ---- | -------- | -------- | ----------- |
22| `signs` | array<string> | yes | body | Array of signs to get (min: 1, max: 12). Allowed values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces. |
23
24## Request Example
25
26```json
27{
28 "signs": ["taurus","cancer","libra"]
29}
30```
31
32## Response Example
33
34```json
35{
36 "data": {
37 "results": [
38 {
39 "sign": "taurus",
40 "date": "2026-05-21",
41 "horoscope": "Your patience will be rewarded. Take time to reflect before making important decisions today.",
42 "lucky_number": 26,
43 "mood": "reflective"
44 },
45 {
46 "sign": "cancer",
47 "date": "2026-05-21",
48 "horoscope": "Your patience will be rewarded. Take time to reflect before making important decisions today.",
49 "lucky_number": 2,
50 "mood": "reflective"
51 },
52 {
53 "sign": "libra",
54 "date": "2026-05-21",
55 "horoscope": "Rest and self-care are essential today. Taking care of yourself enables you to take care of others.",
56 "lucky_number": 82,
57 "mood": "peaceful"
58 }
59 ],
60 "total": 3
61 },
62 "metadata": {
63 "timestamp": "2026-05-21T04:09:20Z"
64 }
65}
66```
67
68## Response Fields
69
70| Field | Type | Description |
71| ----- | ---- | ----------- |
72| `results` | array<object> | List of daily horoscopes returned in the same order as the input signs. |
73| `results[].sign` | string | Zodiac sign the horoscope corresponds to. |
74| `results[].date` | string | Date the horoscope is for, in YYYY-MM-DD format. |
75| `results[].horoscope` | string | Daily horoscope reading for the given sign. |
76| `results[].lucky_number` | integer | Lucky number for the given sign on that date. |
77| `results[].mood` | string | Predicted mood for the given sign on that date. |
78| `total` | integer | Total number of horoscopes returned. |
79
80## Errors
81
82- `422` **validation_failed** — The signs array is missing, empty, or contains more than 12 items, or includes unsupported sign values.
83- `400` **bad_request** — Invalid JSON, malformed request body, or unexpected field types.
gabrielmoreira