# Spaceship Integration via LowCodeAPI

**Last Updated**: February 11, 2026

## Overview

ICANN-accredited registrar.

The Spaceship API provides access to:

- **Domain & Hosting** - Related functionality

## Base Endpoint

```
https://api.lowcodeapi.com/spaceship/
```

**Important**: Always include the provider name in the URL path after `api.lowcodeapi.com/`

## Authentication

LowCodeAPI handles authentication automatically. You only need to:

1. **Sign up** at [Spaceship](https://www.spaceship.com)
2. **Get your credentials** from [credential page](https://www.spaceship.com/application/api-manager)
3. **Connect your account** in LowCodeAPI dashboard
4. **Use your `api_token`** in all requests

The `api_token` is your LowCodeAPI authentication token. LowCodeAPI will automatically:
- Fetch your provider credentials (API keys, OAuth tokens, etc.)
- Apply them to each request
- Handle token refresh for OAuth providers

**Auth Type**: TOKEN

## URL Format (Important)

LowCodeAPI supports **two URL formats** for endpoints with path parameters. **Always try New Format first**, and only fall back to Old Format if it doesn't work.

### New Format (Priority) - Dynamic Path Parameters

- **Path parameters stay in the URL path** - Do NOT convert to query parameters
- **Provider name is always in the URL path** after `api.lowcodeapi.com/`
- Pattern: `https://api.lowcodeapi.com/{provider}/{path_with_params}?api_token={api_token}`

**Example**:
```bash
# New Format - Path parameter stays in the URL path
https://api.lowcodeapi.com/spaceship/resource/{RESOURCE_ID}?api_token=YOUR_API_TOKEN
```

### Old Format (Fallback) - Sanitized Path + Query Parameters

- **Path parameters become query parameters**
- **Provider name is always in the URL path**
- Pattern: `https://api.lowcodeapi.com/{provider}/{sanitized_path}?{path_params}&api_token={api_token}`

**Example**:
```bash
# Old Format - Path parameter becomes a query parameter
https://api.lowcodeapi.com/spaceship/resource/id?id=RESOURCE_ID&api_token=YOUR_API_TOKEN
```

### Decision Flow for AI Agents

1. Always use **New Format first** - Keep path parameters in the URL path
2. If you get a 404 or error, try **Old Format** with sanitized path
3. Log which format worked for future requests to this provider

## API Categories

- **Domains** - 1 endpoints

## Common Endpoints

### Category: Domains

#### Get domain list

**Method**: `GET` | **LowCodeAPI Path**: `/v1/domains`

**New Format (Priority)**:
```bash
https://api.lowcodeapi.com/spaceship/v1/domains?api_token=YOUR_API_TOKEN
```

**Old Format (Fallback)**:
```bash
https://api.lowcodeapi.com/spaceship/v1/domains?orderBy={orderBy}&skip={skip}&take={take}&api_token={api_token}
```

**Description**: Retrieves a paginated list of domains.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `orderBy` | array | No | Specifies fields and order to sort the response items |
| `skip` | string | No | Number of response items to skip |
| `take` | number | No | Number of response items per page |

**Example Request**:
```bash
# NEW FORMAT (PRIORITY) - Path parameters stay in URL
curl -X GET "https://api.lowcodeapi.com/spaceship/v1/domains?orderBy=VALUE&skip=VALUE&take=VALUE&api_token=YOUR_API_TOKEN"
```

**Example Response**:
```json
{
  "data": {
    // Provider response here
  }
}
```

**Official Documentation**: [Get domain list](https://docs.spaceship.dev/#tag/Domains/operation/getDomainList)

---

## API Definition Endpoints

You can retrieve the complete OpenAPI specification for this provider using these endpoints:

**New Format (OpenAPI spec with dynamic path parameters):**
```bash
curl -X GET "https://backend.lowcodeapi.com/spaceship/openapi"
```

**Old Format (API definition with sanitized paths):**
```bash
curl -X GET "https://backend.lowcodeapi.com/spaceship/definition"
```

## Response Format

All responses from LowCodeAPI are wrapped in a `data` key:

```json
{
  "data": {
    // Actual response from provider API
  }
}
```

The `data` key contains the raw response from the provider's API.

## Complete Endpoint Reference

For a complete list of all 1 endpoints, refer to:
- **Official Provider Documentation**: https://docs.spaceship.dev

## Usage Examples

### Example 1: Basic API Request (New Format)

Making a simple request to Spaceship:

```bash
# Replace RESOURCE_ID with an actual resource ID from your Spaceship account
curl -X GET "https://api.lowcodeapi.com/spaceship/resource/{RESOURCE_ID}?api_token=YOUR_API_TOKEN"
```

### Example 2: Request with Query Parameters (New Format)

Request with specific parameters:

```bash
# Include query parameters for filtering
curl -X GET "https://api.lowcodeapi.com/spaceship/resources?filter=value&api_token=YOUR_API_TOKEN"
```

## Error Handling

Standard HTTP status codes apply. All responses are wrapped in a `data` key:
```json
{
  "data": {
    // Actual response from provider
  }
}
```