Guild

Returns a snapshot of the Discord server (guild) the API key is scoped to. Useful for confirming which server a key belongs to and inspecting the public store URL and configured payment methods.

`GET /v1/guild`

Tier: A · Auth: required · Idempotent: N/A

Request

curl https://subscord.com/api/v1/guild \
  -H "Authorization: Bearer ssk_live_..."

This endpoint takes no query parameters.

Response — `200 OK`

{
  "id": "123456789012345678",
  "name": "My Server",
  "store": {
    "name": "My Store",
    "description": "Premium memberships and exclusive content.",
    "url": "https://subscord.com/store/my-server"
  },
  "paymentMethods": {
    "stripe": true,
    "crypto": false
  }
}

Fields

Field	Type	Description
`id`	string	The Discord server ID.
`name`	string	The Discord server name.
`store.name`	string \| null	The customer-facing store name, or `null` if not configured.
`store.description`	string \| null	The store description, or `null` if not configured.
`store.url`	string	The full public URL of the store page. Uses the custom slug if set, otherwise falls back to the server ID.
`paymentMethods.stripe`	boolean	`true` if Stripe is enabled for this server.
`paymentMethods.crypto`	boolean	`true` if at least one crypto wallet is configured.

Errors

Status	Code	When
401	`unauthorized`	Missing, malformed, or revoked API key.
403	`plan_required`	Server is not on the Max plan.
404	`not_found`	The guild record does not exist (rare — only happens if the server was removed from Subscord).

Pagination Products