---
title: "Read this key's server"
method: GET
path: "/v1/server"
tags: ["Servers"]
---

# Read this key's server

`GET /v1/server`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/server`
- Auth: HTTP bearer

The server the key belongs to, whether it is live or a test server, every limit a send on it is held to with how much of it this minute and this month have used, the account's cap on received mail, and the sending domains a from address on it may use.

## Response `200`

The server this key belongs to, its mode, its limits with their use and the domains it may send from.

- object: The server this key belongs to, its mode, its limits with their use and the domains it may send from.
  - `serverId` string, uuid, required: The id every server key, stream and message of the server refers to.
  - `name` string, required: The name given at creation, unique within the account.
  - `mode` 'live' | 'test', required: live delivers; test goes through everything but delivery, so nothing reaches a recipient. Fixed when the server is created.
  - `createdAt` string, date-time, required
  - `limits` object[], required: Every limit a single send is held to: on a live server the account's per-minute limit and monthly cap, and the server's own where Sendora set them; on a test server the test cap its account's test servers share.
    - `scope` 'account' | 'server' | 'test', required: Whose limit it is: `account` for the account's, `server` for the server's own, `test` for the cap the account's test servers share.
    - `period` 'minute' | 'month', required: The UTC minute or the calendar month in UTC the limit counts over.
    - `limit` integer, required: Emails allowed in the period, one per recipient.
    - `used` integer, required: Emails the period has taken so far.
    - `resetsAt` string, date-time, required: When the period ends and the count starts again.
  - `inboundCap` object, nullable, required: The account's monthly cap on received mail, apart from the limits on sending. Past it, mail to the account's inbound addresses and domains is refused for now, so senders retry, until the month ends or the cap is raised.
    - `limit` integer, required: Emails the account may receive in the calendar month in UTC, over every inbound stream. It is the account's monthly cap on sending until an administrator moves it in the dashboard.
    - `used` integer, required: Emails received this month so far, one per recipient.
    - `resetsAt` string, date-time, required: When the month ends and the count starts again.
  - `sendingDomains` object[], required: The account's sending domains a from address on this server may use now: every verified one, one in its 24-hour warning with failingSince set. Sending domains are the account's; an account key or the dashboard adds one.
    - `domain` string, required: The domain, as the part of a from address after the @.
    - `failingSince` string, date-time, nullable, required: When a check first found one of its records missing or wrong; mail keeps going out, and the first check 24 hours after this that still misses one ends the verification. Null while every record is in place.

## Other responses

- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.

---

[API](https://skmtc.dev/sendora/apis/sendora-api.md) · [All operations](https://skmtc.dev/sendora/apis/sendora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendora/apis/sendora-api/revisions/72efbbb34b64?raw)