Charter Captain

Charter Captain Customer Gigs API

The Customer Gigs API from Charter Captain — 3 operation(s) for customer gigs.

GitHub OpenAPI

Operations 4

GET /api/v1/customers/me/gigs/{id} Get customer gig detail #
PATCH /api/v1/customers/me/gigs/{id} Edit customer gig #
POST /api/v1/customers/me/gigs/{id}/bids/{bidId}/accept Accept a bid on customer gig #
POST /api/v1/customers/me/gigs/{id}/bids/accept Accept captain and boat bids #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/chartercaptain-com/openapi/chartercaptain-com-customer-gigs-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-customer-gig-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-captain-profile-schema.json
📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-boat-profile-schema.json
📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-captain-schema.json
📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-booking-schema.json
📊
JSONSchema
https://artifacts.apis.io/chartercaptain-com/json-schema/chartercaptain-com-marketplace-captain-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/chartercaptain-com:chartercaptain-com-customer-gigs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

chartercaptain-com-customer-gigs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Charter Captain Customer Gigs API
  version: 1.0.0
  description: REST API for the Charter Captain iOS apps
servers:
- url: http://localhost:3002
  description: Development
security:
- bearerAuth: []
tags:
- name: Customer Gigs
paths:
  /api/v1/customers/me/gigs/{id}:
    get:
      operationId: getCustomerGig
      summary: Get customer gig detail
      description: Returns full gig detail with bids for the authenticated customer who owns the gig.
      tags:
      - Customer Gigs
      parameters:
      - schema:
          type: string
        required: true
        name: id
        in: path
      responses:
        '200':
          description: Gig detail
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/CustomerGigDetail'
                required:
                - data
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    patch:
      operationId: patchCustomerGig
      summary: Edit customer gig
      description: Edits gig content while the gig is pending verification or open. Slot flags lock once non-withdrawn bids exist.
      tags:
      - Customer Gigs
      parameters:
      - schema:
          type: string
        required: true
        name: id
        in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  minLength: 1
                description:
                  type: string
                harbor:
                  type: string
                  minLength: 1
                boatTypes:
                  type: array
                  items:
                    type: string
                    enum:
                    - POWERBOAT
                    - SAILBOAT
                    - YACHT
                    - PONTOON
                    - FISHING
                  default: []
                dateMode:
                  type: string
                  enum:
                  - SPECIFIC
                  - FLEXIBLE
                  default: SPECIFIC
                dates:
                  type: array
                  items:
                    type:
                    - string
                    - 'null'
                    format: date-time
                  default: []
                flexibleWindowStart:
                  type:
                  - string
                  - 'null'
                  format: date-time
                flexibleWindowEnd:
                  type:
                  - string
                  - 'null'
                  format: date-time
                duration:
                  type: string
                  minLength: 1
                startTime:
                  type: string
                  pattern: ^([01]\d|2[0-3]):[0-5]\d$
                timeWindow:
                  type: string
                  enum:
                  - MORNING
                  - AFTERNOON
                  - SUNSET
                  - EVENING
                  - FLEXIBLE
                compensationCents:
                  type: integer
                  exclusiveMinimum: 0
                occasion:
                  type: string
                  enum:
                  - corporate-outings
                  - bachelorette-party
                  - proposal
                  - milestone-birthday
                  - general
                partySize:
                  type: integer
                  minimum: 1
                  maximum: 150
                needsCaptain:
                  type: boolean
                needsBoat:
                  type: boolean
              required:
              - title
              - harbor
              - duration
              - needsCaptain
              - needsBoat
      responses:
        '200':
          description: Gig updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      ok:
                        type: boolean
                        enum:
                        - true
                    required:
                    - ok
                required:
                - data
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /api/v1/customers/me/gigs/{id}/bids/{bidId}/accept:
    post:
      operationId: postCustomerGigBidAccept
      summary: Accept a bid on customer gig
      description: Accepts a single submitted bid on an open gig owned by the authenticated customer.
      tags:
      - Customer Gigs
      parameters:
      - schema:
          type: string
        required: true
        name: id
        in: path
      - schema:
          type: string
        required: true
        name: bidId
        in: path
      responses:
        '200':
          description: Bid accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      ok:
                        type: boolean
                        enum:
                        - true
                    required:
                    - ok
                required:
                - data
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /api/v1/customers/me/gigs/{id}/bids/accept:
    post:
      operationId: postCustomerGigBidsAccept
      summary: Accept captain and boat bids
      description: Atomically accepts captain and/or boat bids on a two-slot open gig owned by the authenticated customer.
      tags:
      - Customer Gigs
      parameters:
      - schema:
          type: string
        required: true
        name: id
        in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                captainBidId:
                  type:
                  - string
                  - 'null'
                boatBidId:
                  type:
                  - string
                  - 'null'
      responses:
        '200':
          description: Bids accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      ok:
                        type: boolean
                        enum:
                        - true
                    required:
                    - ok
                required:
                - data
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    NotFound:
      description: The requested resource does not exist (existence is not leaked).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication required, or the bearer token is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Authenticated but not permitted to access this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ValidationError:
      description: Request body or query parameters failed validation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
          required:
          - message
          - code
      required:
      - error
    CustomerGigDetail:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        description:
          type:
          - string
          - 'null'
        harbor:
          type: string
        boatTypes:
          type: array
          items:
            type: string
            enum:
            - POWERBOAT
            - SAILBOAT
            - YACHT
            - PONTOON
            - FISHING
          default: []
        date:
          type: string
          format: date
        startTime:
          type:
          - string
          - 'null'
        duration:
          type: string
        compensationCents:
          type:
          - integer
          - 'null'
        needsCaptain:
          type: boolean
        needsBoat:
          type: boolean
        status:
          type: string
        bids:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              slot:
                type: string
                enum:
                - CAPTAIN
                - BOAT
              status:
                type: string
                enum:
                - SUBMITTED
                - SELECTED
                - APPROVED
                - VETOED
                - WITHDRAWN
              proposedRateCents:
                type: integer
              message:
                type:
                - string
                - 'null'
              bidderTenant:
                type: object
                properties:
                  id:
                    type: string
                  displayName:
                    type: string
                  slug:
                    type:
                    - string
                    - 'null'
                required:
                - id
                - displayName
              boat:
                type:
                - object
                - 'null'
                properties:
                  id:
                    type: string
                  name:
                    type: string
                required:
                - id
                - name
            required:
            - id
            - slot
            - status
            - proposedRateCents
            - bidderTenant
        convertedBooking:
          type:
          - object
          - 'null'
          properties:
            id:
              type: string
            status:
              type: string
            date:
              type: string
              format: date
          required:
          - id
          - status
          - date
      required:
      - id
      - title
      - harbor
      - date
      - duration
      - needsCaptain
      - needsBoat
      - status
      - bids
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Clerk JWT token