# Basic Utils Agent – Datetime Add

> Basic Utils Agent – Datetime Add is a paid API for AI agents from basic-utils-agent.up.railway.app, paid per call via x402, $0.0015/call, status unknown (last checked 2026-09-14).

Adds a specified number of days to a given base date and returns the resulting datetime.

## Facts

- Endpoint: POST https://basic-utils-agent.up.railway.app/datetime/add
- Price: $0.0015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basic-utils-agent-datetime-add-6e7b0e99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ef_JUwjTV4PzAv-jNYnSs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability basic-utils-agent-datetime-add-6e7b0e99 -d '<json body>'
```

Example prompt: What date is 45 days after January 1, 2025? Use the datetime add endpoint and give me back the resulting date.

## When to prefer this

Choose this endpoint when you need to compute a future date by adding a fixed number of days to a known base date — for example, calculating expiration dates, deadlines, or delivery windows. It is simple, fast, and stateless, making it ideal for scheduling logic within agentic workflows.

## Known failure modes

- Invalid or malformed date string causes a 422 validation error
- Missing required 'date' or 'days' fields returns an error response
- Null values passed for both 'date' and 'days' with no fallback results in an error
- Non-integer value for 'days' fails schema validation

## How this service works

A versatile utility agent offering calculator, statistics, datetime, and unit conversion services.

## Output

Returns a JSON object with a 'result' field containing the computed datetime in ISO 8601 format (e.g. '2024-01-08T00:00:00') after adding the specified number of days to the base date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "anyOf": [
    {
     "type": "string",
     "format": "date-time"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The base date for the operation (required for add, subtract, difference, and day-of-week operations)"
  },
  "days": {
   "anyOf": [
    {
     "type": "integer"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Number of days to add or subtract from the date (required for add and subtract operations)"
  },
  "date2": {
   "anyOf": [
    {
     "type": "string",
     "format": "date-time"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The second date for difference calculation (required for difference operation)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": "2024-01-08T00:00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basic-utils-agent-datetime-add-6e7b0e99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from basic-utils-agent.up.railway.app](https://www.zero.xyz/host/basic-utils-agent.up.railway.app/llms.txt)