Overview

Codeship is a hosted CI platform (now part of CloudBees) that automatically builds and tests your code on every Git push. Note that Codeship reached end-of-life in 2023 — existing accounts still function but no new accounts are being created. The API lets you list projects, retrieve build details, and restart failed builds; it is most useful for teams that already have active Codeship projects and want to integrate build status into other tools.

Beginner Tip

Authenticate with `https://codeship.com/api/v1/authenticate.json` using your username and password to receive a short-lived token, then pass that token in all subsequent requests. Token sessions last 60 minutes.

Available Data

IP address information
geographic location
ASN and ISP data

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Codeship",
    "description": "Codeship is a Continuous Integration Platform in the cloud",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

api_key Session token returned on successful authentication — include this in subsequent requests as a query parameter `api_key`.
id Unique numeric ID for the authenticated user account.
organizations List of organizations the user belongs to, each with an `id` and `name`.

Implementation Example

Request
const url = "https://docs.cloudbees.com/docs/cloudbees-codeship/latest/api-overview/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Invalid credentials Wrong username/password in the authentication request, or the session token has expired.
Re-authenticate by POSTing to `/api/v1/authenticate.json` with your Codeship email and password to get a fresh token.
403 Forbidden on project endpoints The authenticated user does not have access to the requested project.
Confirm the project UUID using `GET /api/v1/projects.json` and verify the account has at least Viewer access on that project.
API unresponsive / connection refused Codeship reached EOL in 2023; some endpoints may be intermittently unavailable.
Check the CloudBees status page and consider migrating to an actively maintained CI service such as GitHub Actions or CircleCI.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →