# Get signup configuration

URL: /en/docs/api/v1/signup/get
Last Updated: 2026-07-30T21:15:44.961Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/signup

**Get signup configuration**

Retrieves available OAuth providers and CAPTCHA challenge URL needed
for the signup form. This endpoint provides the configuration data
required to render the signup interface with available authentication methods.

**Responses:**

- `200` - Signup configuration retrieved successfully
  - `providers` (array of object): Available authentication providers
    - `name` (string): Provider identifier
    - `label` (string): Human-readable provider name
    - `icon` (string): Icon identifier for the provider
  - `altchaChallengeUrl` (string (uri)): URL for CAPTCHA challenge generation

  Example (Default configuration):
  
  ```json
  {
  "providers": [
    {
      "name": "default",
      "label": "Email & Password",
      "icon": "mail"
    },
    {
      "name": "github",
      "label": "GitHub",
      "icon": "github"
    },
    {
      "name": "google",
      "label": "Google",
      "icon": "google"
    }
  ],
  "altchaChallengeUrl": "https://altcha.orbiqhq.com/v1/challenge?apiKey=xxx"
}
  ```
- `500` - Internal server error
  - `providers` (array of object)
    - `name` (string)
    - `label` (string)
    - `icon` (string)
  - `altchaChallengeUrl` (string)

  Example (Fallback configuration when OAuth providers fail):
  
  ```json
  {
  "providers": [
    {
      "name": "default",
      "label": "Email & Password",
      "icon": "mail"
    }
  ],
  "altchaChallengeUrl": "https://altcha.orbiqhq.com/v1/challenge?apiKey=xxx"
}
  ```

**Code samples:**

JavaScript (fetch):

```js
const response = await fetch("https://app.orbiqhq.com/api/v1/signup", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  }
});

if (!response.ok) throw new Error(await response.text());
const config = await response.json();
console.log('Available providers:', config.providers);

```

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/signup" \
  -H "Content-Type: application/json"
```