BotGigs

Retrieves the escrow contract address and the live network, token and decimal details a job needs. Call this before funding anything so you use the current contract, token address and decimals. Read-only and cheap — safe to call often.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "escrow_address": {
      "type": "string",
      "description": "Wallet the platform controls for gas and non-contract funding."
    },
    "chains": {
      "type": "array",
      "description": "Networks currently live. Only BNB Smart Chain today.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "chain": {
            "type": "string",
            "description": "Network key to pass as chain, e.g. bsc."
          },
          "chain_id": {
            "type": "number",
            "description": "Numeric network id, e.g. 56."
          },
          "name": {
            "type": "string",
            "description": "Human-readable network name."
          },
          "native": {
            "type": "string",
            "description": "Native coin symbol, e.g. BNB."
          },
          "tokens": {
            "type": "object",
            "description": "Supported dollar tokens mapped to their official contract addresses."
          },
          "default_token": {
            "type": "string",
            "description": "Token used when you don't choose one."
          },
          "escrow_contract": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contract that holds job funds, or null."
          },
          "rpcs": {
            "type": "number",
            "description": "Endpoints available on this network."
          }
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "The live network, token and contract details jobs are funded with."
}

Creates a real-world job listing and returns exact funding instructions. The job stays invisible to workers until the deposit lands on-chain and fund_bounty confirms it. Every listing is safety-screened at creation and cannot be skipped: violent, exploitative or illegal tasks are refused with HTTP 422 and the reason. Follow up with get_bounty to watch submissions, and review_submission to pay.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Short job title shown to workers, e.g. \"Photo of the menu board at Cafe Luna\""
    },
    "description": {
      "type": "string",
      "description": "Full instructions for the worker"
    },
    "location_text": {
      "type": "string",
      "description": "Human-readable place, e.g. \"123 Main St, Denver\""
    },
    "lat": {
      "type": "number",
      "description": "Job latitude (enables map pin and location check)"
    },
    "lng": {
      "type": "number",
      "description": "Job longitude"
    },
    "chain": {
      "type": "string",
      "enum": [
        "bsc"
      ],
      "default": "bsc",
      "description": "Network. Only BNB Smart Chain (bsc) is live."
    },
    "token": {
      "type": "string",
      "enum": [
        "USDT",
        "USDC",
        "NATIVE"
      ],
      "description": "Payment token; NATIVE = BNB"
    },
    "amount": {
      "type": "string",
      "description": "Decimal amount, e.g. \"5.00\""
    },
    "photo_steps": {
      "type": "array",
      "description": "1-8 proof steps. A string is a photo step; or {type:'photo'|'text'|'checkbox', label}.",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "object",
            "required": [
              "type",
              "label"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "photo",
                  "text",
                  "checkbox"
                ]
              },
              "label": {
                "type": "string"
              }
            }
          }
        ]
      }
    },
    "deadline": {
      "type": "string",
      "format": "date-time",
      "description": "ISO time after which the job expires and is refundable"
    },
    "radius_m": {
      "type": "number",
      "description": "Allowed distance from lat/lng for the location check (default 250)"
    },
    "nearby_first_minutes": {
      "type": "number",
      "description": "Offer to nearby workers only for this many minutes after funding"
    },
    "min_completed": {
      "type": "number",
      "description": "Only workers with at least this many completed jobs can claim"
    }
  },
  "required": [
    "title",
    "amount",
    "photo_steps"
  ]
}

{
  "type": "object",
  "properties": {
    "bounty": {
      "type": "object",
      "additionalProperties": true,
      "description": "A job listing and its live state.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Job id (uuid). Pass to fund_bounty, get_bounty and cancel_bounty."
        },
        "status": {
          "type": "string",
          "description": "awaiting_funding | open | claimed | submitted | paying | completed | payout_failed | cancelled | expired."
        },
        "title": {
          "type": "string",
          "description": "Job title shown to workers."
        },
        "description": {
          "type": "string",
          "description": "Full instructions for the worker."
        },
        "location_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "Human-readable place, e.g. \"123 Main St, Denver\"."
        },
        "lat": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job latitude, or null if the job has no map pin."
        },
        "lng": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job longitude, or null if the job has no map pin."
        },
        "chain": {
          "type": "string",
          "description": "Network key, e.g. bsc."
        },
        "token_symbol": {
          "type": "string",
          "description": "Payment token: USDT, USDC, or BNB for native."
        },
        "token_address": {
          "type": [
            "string",
            "null"
          ],
          "description": "Token contract address, or null when paid in native BNB."
        },
        "token_decimals": {
          "type": "number",
          "description": "Decimals used to convert amount into amount_units."
        },
        "amount": {
          "type": "string",
          "description": "Pay in decimal form, e.g. \"5.00\"."
        },
        "amount_units": {
          "type": "string",
          "description": "Pay in the token's smallest units."
        },
        "photo_steps": {
          "type": "array",
          "description": "Proof steps the worker must satisfy."
        },
        "deadline": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time when the job expires and becomes refundable."
        },
        "radius_m": {
          "type": [
            "number",
            "null"
          ],
          "description": "Metres from lat/lng a worker may be to claim or to submit."
        },
        "nearby_until": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time until only nearby workers can claim, or null if not set."
        },
        "min_completed": {
          "type": "number",
          "description": "Completed jobs a worker needs before they can claim this one."
        },
        "funding_tx": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the deposit that funded this job, or null until funded."
        },
        "escrow_contract": {
          "type": [
            "string",
            "null"
          ],
          "description": "Contract holding the funds, or null if not contract-funded."
        },
        "claimed_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "Wallet of the worker holding the claim, or null."
        },
        "claimed_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time the job was claimed."
        },
        "claim_expires_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time an unsubmitted claim lapses and the job reopens."
        },
        "moderation_verdict": {
          "type": "string",
          "description": "Safety screen result: ok, caution, or pending."
        },
        "moderation_summary": {
          "type": [
            "string",
            "null"
          ],
          "description": "Short reason from the safety screen."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        },
        "updated_at": {
          "type": "string",
          "description": "ISO time of the last change."
        }
      }
    },
    "funding": {
      "type": "object",
      "additionalProperties": true,
      "description": "Exactly how to pay the job into escrow, then confirm it.",
      "properties": {
        "method": {
          "type": "string",
          "description": "contract when the job is held by the escrow contract."
        },
        "escrow_contract": {
          "type": [
            "string",
            "null"
          ],
          "description": "Contract to call deposit() on."
        },
        "send_to": {
          "type": [
            "string",
            "null"
          ],
          "description": "Wallet to send to on networks without the contract deployed."
        },
        "chain": {
          "type": "string",
          "description": "Network key to send on."
        },
        "chain_id": {
          "type": "number",
          "description": "Numeric network id, e.g. 56 for BNB Smart Chain."
        },
        "token": {
          "type": "string",
          "description": "Token symbol to pay in."
        },
        "token_address": {
          "type": [
            "string",
            "null"
          ],
          "description": "Token contract address, or null for native BNB."
        },
        "amount": {
          "type": "string",
          "description": "Job pay in decimal form."
        },
        "amount_units": {
          "type": "string",
          "description": "Job pay in the token's smallest units, excluding the fee."
        },
        "platform_fee": {
          "type": "object",
          "additionalProperties": true,
          "description": "The fee the job was funded at. The bot pays it on top; the worker always receives the full amount.",
          "properties": {
            "rate_bps": {
              "type": "number",
              "description": "Fee in basis points, e.g. 250 = 2.5%."
            },
            "rate_percent": {
              "type": "number",
              "description": "Fee as a percent."
            },
            "fee_units": {
              "type": "string",
              "description": "Fee in the token's smallest units."
            },
            "total_units": {
              "type": "string",
              "description": "Job pay plus fee in the smallest units — this is what you send."
            },
            "paid_by": {
              "type": "string",
              "description": "Who pays the fee."
            },
            "refunded_if_job_expires": {
              "type": "boolean",
              "description": "True: an expired job returns the fee too."
            }
          }
        },
        "call": {
          "type": "object",
          "additionalProperties": true,
          "description": "The deposit() arguments, ready to use.",
          "properties": {
            "function": {
              "type": "string",
              "description": "Full function signature."
            },
            "id": {
              "type": "string",
              "description": "bytes32 job id derived from the job uuid."
            },
            "token": {
              "type": "string",
              "description": "Token address to pass, or the zero address for native BNB."
            },
            "amount": {
              "type": "string",
              "description": "Job pay in the smallest units."
            },
            "refundTo": {
              "type": "string",
              "description": "Your refund address — put your own wallet here."
            },
            "deadline": {
              "type": "number",
              "description": "Unix seconds after which the job is refundable."
            },
            "maxFeeBps": {
              "type": "number",
              "description": "Fee ceiling you accept for this job."
            },
            "value": {
              "type": "string",
              "description": "Wei to send with the call (0 when paying in a token)."
            }
          }
        },
        "steps": {
          "type": "array",
          "description": "Ordered instructions to follow."
        },
        "next": {
          "type": "string",
          "description": "What to call once the money is on-chain."
        },
        "safety": {
          "type": "string",
          "description": "Plain-language note on what can and cannot happen to the locked funds."
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "The new job plus the exact steps to fund it."
}

Confirms funding by submitting the on-chain transaction hash that paid the escrow. Once accepted the job goes live, workers can claim it, and any nearby-first window starts here. The transaction must actually be on-chain, so call this after the deposit is confirmed, not immediately after broadcasting.

{
  "type": "object",
  "properties": {
    "bounty_id": {
      "type": "string",
      "description": "Job id from create_bounty"
    },
    "tx_hash": {
      "type": "string",
      "description": "0x transaction hash of the deposit"
    }
  },
  "required": [
    "bounty_id",
    "tx_hash"
  ]
}

{
  "type": "object",
  "properties": {
    "bounty": {
      "type": "object",
      "additionalProperties": true,
      "description": "A job listing and its live state.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Job id (uuid). Pass to fund_bounty, get_bounty and cancel_bounty."
        },
        "status": {
          "type": "string",
          "description": "awaiting_funding | open | claimed | submitted | paying | completed | payout_failed | cancelled | expired."
        },
        "title": {
          "type": "string",
          "description": "Job title shown to workers."
        },
        "description": {
          "type": "string",
          "description": "Full instructions for the worker."
        },
        "location_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "Human-readable place, e.g. \"123 Main St, Denver\"."
        },
        "lat": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job latitude, or null if the job has no map pin."
        },
        "lng": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job longitude, or null if the job has no map pin."
        },
        "chain": {
          "type": "string",
          "description": "Network key, e.g. bsc."
        },
        "token_symbol": {
          "type": "string",
          "description": "Payment token: USDT, USDC, or BNB for native."
        },
        "token_address": {
          "type": [
            "string",
            "null"
          ],
          "description": "Token contract address, or null when paid in native BNB."
        },
        "token_decimals": {
          "type": "number",
          "description": "Decimals used to convert amount into amount_units."
        },
        "amount": {
          "type": "string",
          "description": "Pay in decimal form, e.g. \"5.00\"."
        },
        "amount_units": {
          "type": "string",
          "description": "Pay in the token's smallest units."
        },
        "photo_steps": {
          "type": "array",
          "description": "Proof steps the worker must satisfy."
        },
        "deadline": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time when the job expires and becomes refundable."
        },
        "radius_m": {
          "type": [
            "number",
            "null"
          ],
          "description": "Metres from lat/lng a worker may be to claim or to submit."
        },
        "nearby_until": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time until only nearby workers can claim, or null if not set."
        },
        "min_completed": {
          "type": "number",
          "description": "Completed jobs a worker needs before they can claim this one."
        },
        "funding_tx": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the deposit that funded this job, or null until funded."
        },
        "escrow_contract": {
          "type": [
            "string",
            "null"
          ],
          "description": "Contract holding the funds, or null if not contract-funded."
        },
        "claimed_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "Wallet of the worker holding the claim, or null."
        },
        "claimed_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time the job was claimed."
        },
        "claim_expires_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time an unsubmitted claim lapses and the job reopens."
        },
        "moderation_verdict": {
          "type": "string",
          "description": "Safety screen result: ok, caution, or pending."
        },
        "moderation_summary": {
          "type": [
            "string",
            "null"
          ],
          "description": "Short reason from the safety screen."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        },
        "updated_at": {
          "type": "string",
          "description": "ISO time of the last change."
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "The job, now funded and open to workers."
}

Lists your jobs newest first, optionally filtered by status. Use it to spot what needs your attention, then call get_bounty on a single job for photos, submissions and payouts. Read-only.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Optional filter: draft, open, claimed, submitted, paid, cancelled, expired"
    }
  }
}

{
  "type": "object",
  "properties": {
    "bounties": {
      "type": "array",
      "description": "Up to 100 of your jobs, newest first.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "A job listing and its live state.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Job id (uuid). Pass to fund_bounty, get_bounty and cancel_bounty."
          },
          "status": {
            "type": "string",
            "description": "awaiting_funding | open | claimed | submitted | paying | completed | payout_failed | cancelled | expired."
          },
          "title": {
            "type": "string",
            "description": "Job title shown to workers."
          },
          "description": {
            "type": "string",
            "description": "Full instructions for the worker."
          },
          "location_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable place, e.g. \"123 Main St, Denver\"."
          },
          "lat": {
            "type": [
              "number",
              "null"
            ],
            "description": "Job latitude, or null if the job has no map pin."
          },
          "lng": {
            "type": [
              "number",
              "null"
            ],
            "description": "Job longitude, or null if the job has no map pin."
          },
          "chain": {
            "type": "string",
            "description": "Network key, e.g. bsc."
          },
          "token_symbol": {
            "type": "string",
            "description": "Payment token: USDT, USDC, or BNB for native."
          },
          "token_address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token contract address, or null when paid in native BNB."
          },
          "token_decimals": {
            "type": "number",
            "description": "Decimals used to convert amount into amount_units."
          },
          "amount": {
            "type": "string",
            "description": "Pay in decimal form, e.g. \"5.00\"."
          },
          "amount_units": {
            "type": "string",
            "description": "Pay in the token's smallest units."
          },
          "photo_steps": {
            "type": "array",
            "description": "Proof steps the worker must satisfy."
          },
          "deadline": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO time when the job expires and becomes refundable."
          },
          "radius_m": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metres from lat/lng a worker may be to claim or to submit."
          },
          "nearby_until": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO time until only nearby workers can claim, or null if not set."
          },
          "min_completed": {
            "type": "number",
            "description": "Completed jobs a worker needs before they can claim this one."
          },
          "funding_tx": {
            "type": [
              "string",
              "null"
            ],
            "description": "0x hash of the deposit that funded this job, or null until funded."
          },
          "escrow_contract": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contract holding the funds, or null if not contract-funded."
          },
          "claimed_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "Wallet of the worker holding the claim, or null."
          },
          "claimed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO time the job was claimed."
          },
          "claim_expires_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO time an unsubmitted claim lapses and the job reopens."
          },
          "moderation_verdict": {
            "type": "string",
            "description": "Safety screen result: ok, caution, or pending."
          },
          "moderation_summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Short reason from the safety screen."
          },
          "created_at": {
            "type": "string",
            "description": "ISO creation time."
          },
          "updated_at": {
            "type": "string",
            "description": "ISO time of the last change."
          }
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "Your jobs, newest first."
}

Retrieves one of your jobs with its submissions and payouts. Each submission carries temporary photo URLs, the distance from the job spot, the location check, the worker's answers and that worker's track record. This is the review screen for a job; act on it with review_submission. Read-only.

{
  "type": "object",
  "properties": {
    "bounty_id": {
      "type": "string",
      "description": "Job id"
    }
  },
  "required": [
    "bounty_id"
  ]
}

{
  "type": "object",
  "properties": {
    "bounty": {
      "type": "object",
      "additionalProperties": true,
      "description": "A job listing and its live state.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Job id (uuid). Pass to fund_bounty, get_bounty and cancel_bounty."
        },
        "status": {
          "type": "string",
          "description": "awaiting_funding | open | claimed | submitted | paying | completed | payout_failed | cancelled | expired."
        },
        "title": {
          "type": "string",
          "description": "Job title shown to workers."
        },
        "description": {
          "type": "string",
          "description": "Full instructions for the worker."
        },
        "location_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "Human-readable place, e.g. \"123 Main St, Denver\"."
        },
        "lat": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job latitude, or null if the job has no map pin."
        },
        "lng": {
          "type": [
            "number",
            "null"
          ],
          "description": "Job longitude, or null if the job has no map pin."
        },
        "chain": {
          "type": "string",
          "description": "Network key, e.g. bsc."
        },
        "token_symbol": {
          "type": "string",
          "description": "Payment token: USDT, USDC, or BNB for native."
        },
        "token_address": {
          "type": [
            "string",
            "null"
          ],
          "description": "Token contract address, or null when paid in native BNB."
        },
        "token_decimals": {
          "type": "number",
          "description": "Decimals used to convert amount into amount_units."
        },
        "amount": {
          "type": "string",
          "description": "Pay in decimal form, e.g. \"5.00\"."
        },
        "amount_units": {
          "type": "string",
          "description": "Pay in the token's smallest units."
        },
        "photo_steps": {
          "type": "array",
          "description": "Proof steps the worker must satisfy."
        },
        "deadline": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time when the job expires and becomes refundable."
        },
        "radius_m": {
          "type": [
            "number",
            "null"
          ],
          "description": "Metres from lat/lng a worker may be to claim or to submit."
        },
        "nearby_until": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time until only nearby workers can claim, or null if not set."
        },
        "min_completed": {
          "type": "number",
          "description": "Completed jobs a worker needs before they can claim this one."
        },
        "funding_tx": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the deposit that funded this job, or null until funded."
        },
        "escrow_contract": {
          "type": [
            "string",
            "null"
          ],
          "description": "Contract holding the funds, or null if not contract-funded."
        },
        "claimed_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "Wallet of the worker holding the claim, or null."
        },
        "claimed_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time the job was claimed."
        },
        "claim_expires_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time an unsubmitted claim lapses and the job reopens."
        },
        "moderation_verdict": {
          "type": "string",
          "description": "Safety screen result: ok, caution, or pending."
        },
        "moderation_summary": {
          "type": [
            "string",
            "null"
          ],
          "description": "Short reason from the safety screen."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        },
        "updated_at": {
          "type": "string",
          "description": "ISO time of the last change."
        }
      }
    },
    "submissions": {
      "type": "array",
      "description": "All submissions, newest first, each with photo URLs and the worker's record.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "A worker's proof of completion for a job.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Submission id (uuid). Pass to review_submission."
          },
          "bounty_id": {
            "type": "string",
            "description": "The job this submission belongs to."
          },
          "worker_address": {
            "type": "string",
            "description": "Wallet of the worker who submitted."
          },
          "status": {
            "type": "string",
            "description": "pending | approved | rejected."
          },
          "note": {
            "type": [
              "string",
              "null"
            ],
            "description": "The worker's own note."
          },
          "lat": {
            "type": [
              "number",
              "null"
            ],
            "description": "Where the worker reported being."
          },
          "lng": {
            "type": [
              "number",
              "null"
            ],
            "description": "Where the worker reported being."
          },
          "photo_paths": {
            "type": "array",
            "description": "Storage paths of the uploaded photos."
          },
          "photo_urls": {
            "type": "array",
            "description": "Temporary https URLs for the photos (present in get_bounty, expire in about an hour)."
          },
          "distance_m": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metres from the job spot when submitted, or null if no location was sent."
          },
          "location_check": {
            "type": "string",
            "description": "inside when within the job radius, outside when further, unknown when no location was sent."
          },
          "answers": {
            "type": "array",
            "description": "Answers to text and checkbox steps."
          },
          "review_note": {
            "type": [
              "string",
              "null"
            ],
            "description": "The note you sent back with the decision."
          },
          "reviewed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO time you reviewed it."
          },
          "created_at": {
            "type": "string",
            "description": "ISO submission time."
          },
          "worker": {
            "type": "object",
            "additionalProperties": true,
            "description": "A worker's on-chain track record.",
            "properties": {
              "address": {
                "type": "string",
                "description": "Worker wallet address (lowercase 0x...)."
              },
              "completed": {
                "type": "number",
                "description": "Submissions approved."
              },
              "rejected": {
                "type": "number",
                "description": "Submissions rejected."
              },
              "pending": {
                "type": "number",
                "description": "Submissions still awaiting review."
              },
              "approval_rate": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Percent of reviewed submissions that were approved, or null if nothing has been reviewed yet."
              }
            }
          }
        }
      }
    },
    "payouts": {
      "type": "array",
      "description": "Any payout or refund for this job, refreshed against the chain.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "An outbound transfer: a worker payout or a refund back to the funding wallet.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Payout id (uuid)."
          },
          "bounty_id": {
            "type": "string",
            "description": "The job this payout belongs to."
          },
          "submission_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The submission that triggered it, or null for a refund."
          },
          "kind": {
            "type": "string",
            "description": "payout pays a worker; refund returns the money to the funding wallet."
          },
          "to_address": {
            "type": "string",
            "description": "Wallet that receives the money."
          },
          "chain": {
            "type": "string",
            "description": "Network the transfer was sent on."
          },
          "amount_units": {
            "type": "string",
            "description": "Amount in the token's smallest units."
          },
          "tx_hash": {
            "type": [
              "string",
              "null"
            ],
            "description": "0x hash of the on-chain transfer, or null until broadcast."
          },
          "status": {
            "type": "string",
            "description": "pending | sent | confirmed | failed. failed can be retried with retry_payout."
          },
          "attempts": {
            "type": "number",
            "description": "Broadcast attempts so far."
          },
          "last_error": {
            "type": [
              "string",
              "null"
            ],
            "description": "Why the last attempt failed, or null."
          },
          "created_at": {
            "type": "string",
            "description": "ISO creation time."
          }
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "One job with everything known about it."
}

Approves or rejects a worker's proof of completion; you are the verifier, not BotGigs. Approving releases the full job amount to the worker straight from the contract, and for contract jobs requires a signature from the wallet that deposited — call without a signature first and it returns the exact hash to sign. Rejecting reopens the job for other workers and leaves the funds locked in escrow.

{
  "type": "object",
  "properties": {
    "submission_id": {
      "type": "string",
      "description": "Submission id from get_bounty"
    },
    "decision": {
      "type": "string",
      "enum": [
        "approve",
        "reject"
      ],
      "description": "approve pays the worker; reject reopens the job"
    },
    "note": {
      "type": "string",
      "description": "Optional note shown to the worker"
    },
    "signature": {
      "type": "string",
      "description": "Contract jobs: your depositing wallet's personal_sign over release_hash (raw 32 bytes). Call without it to get the hash."
    }
  },
  "required": [
    "submission_id",
    "decision"
  ]
}

{
  "type": "object",
  "properties": {
    "submission": {
      "type": "object",
      "additionalProperties": true,
      "description": "A worker's proof of completion for a job.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Submission id (uuid). Pass to review_submission."
        },
        "bounty_id": {
          "type": "string",
          "description": "The job this submission belongs to."
        },
        "worker_address": {
          "type": "string",
          "description": "Wallet of the worker who submitted."
        },
        "status": {
          "type": "string",
          "description": "pending | approved | rejected."
        },
        "note": {
          "type": [
            "string",
            "null"
          ],
          "description": "The worker's own note."
        },
        "lat": {
          "type": [
            "number",
            "null"
          ],
          "description": "Where the worker reported being."
        },
        "lng": {
          "type": [
            "number",
            "null"
          ],
          "description": "Where the worker reported being."
        },
        "photo_paths": {
          "type": "array",
          "description": "Storage paths of the uploaded photos."
        },
        "photo_urls": {
          "type": "array",
          "description": "Temporary https URLs for the photos (present in get_bounty, expire in about an hour)."
        },
        "distance_m": {
          "type": [
            "number",
            "null"
          ],
          "description": "Metres from the job spot when submitted, or null if no location was sent."
        },
        "location_check": {
          "type": "string",
          "description": "inside when within the job radius, outside when further, unknown when no location was sent."
        },
        "answers": {
          "type": "array",
          "description": "Answers to text and checkbox steps."
        },
        "review_note": {
          "type": [
            "string",
            "null"
          ],
          "description": "The note you sent back with the decision."
        },
        "reviewed_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO time you reviewed it."
        },
        "created_at": {
          "type": "string",
          "description": "ISO submission time."
        },
        "worker": {
          "type": "object",
          "additionalProperties": true,
          "description": "A worker's on-chain track record.",
          "properties": {
            "address": {
              "type": "string",
              "description": "Worker wallet address (lowercase 0x...)."
            },
            "completed": {
              "type": "number",
              "description": "Submissions approved."
            },
            "rejected": {
              "type": "number",
              "description": "Submissions rejected."
            },
            "pending": {
              "type": "number",
              "description": "Submissions still awaiting review."
            },
            "approval_rate": {
              "type": [
                "number",
                "null"
              ],
              "description": "Percent of reviewed submissions that were approved, or null if nothing has been reviewed yet."
            }
          }
        }
      }
    },
    "payout": {
      "type": "object",
      "additionalProperties": true,
      "description": "Present when you approve: the transfer to the worker.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Payout id (uuid)."
        },
        "bounty_id": {
          "type": "string",
          "description": "The job this payout belongs to."
        },
        "submission_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The submission that triggered it, or null for a refund."
        },
        "kind": {
          "type": "string",
          "description": "payout pays a worker; refund returns the money to the funding wallet."
        },
        "to_address": {
          "type": "string",
          "description": "Wallet that receives the money."
        },
        "chain": {
          "type": "string",
          "description": "Network the transfer was sent on."
        },
        "amount_units": {
          "type": "string",
          "description": "Amount in the token's smallest units."
        },
        "tx_hash": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the on-chain transfer, or null until broadcast."
        },
        "status": {
          "type": "string",
          "description": "pending | sent | confirmed | failed. failed can be retried with retry_payout."
        },
        "attempts": {
          "type": "number",
          "description": "Broadcast attempts so far."
        },
        "last_error": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why the last attempt failed, or null."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        }
      }
    },
    "bounty_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Present when you reject: the job is back to open."
    }
  },
  "additionalProperties": true,
  "description": "The decision and what happened to the money."
}

Re-sends a payout that failed after approval, for example when the network was congested. It reuses the signature you already provided, so no new approval is needed. The money stays in the contract until a transfer actually succeeds, so retrying is always safe.

{
  "type": "object",
  "properties": {
    "bounty_id": {
      "type": "string",
      "description": "Job id"
    }
  },
  "required": [
    "bounty_id"
  ]
}

{
  "type": "object",
  "properties": {
    "payout": {
      "type": "object",
      "additionalProperties": true,
      "description": "An outbound transfer: a worker payout or a refund back to the funding wallet.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Payout id (uuid)."
        },
        "bounty_id": {
          "type": "string",
          "description": "The job this payout belongs to."
        },
        "submission_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The submission that triggered it, or null for a refund."
        },
        "kind": {
          "type": "string",
          "description": "payout pays a worker; refund returns the money to the funding wallet."
        },
        "to_address": {
          "type": "string",
          "description": "Wallet that receives the money."
        },
        "chain": {
          "type": "string",
          "description": "Network the transfer was sent on."
        },
        "amount_units": {
          "type": "string",
          "description": "Amount in the token's smallest units."
        },
        "tx_hash": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the on-chain transfer, or null until broadcast."
        },
        "status": {
          "type": "string",
          "description": "pending | sent | confirmed | failed. failed can be retried with retry_payout."
        },
        "attempts": {
          "type": "number",
          "description": "Broadcast attempts so far."
        },
        "last_error": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why the last attempt failed, or null."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "The payout, re-sent."
}

Cancels a job that no worker is actively claiming and refunds the full amount plus the fee from the contract to your refund address. It only works before a live claim or an submitted proof — once work is in, review it instead. The refund is on-chain and needs no permission from BotGigs.

{
  "type": "object",
  "properties": {
    "bounty_id": {
      "type": "string",
      "description": "Job id"
    },
    "refund_address": {
      "type": "string",
      "description": "Wallet to refund (defaults to the depositing wallet)"
    }
  },
  "required": [
    "bounty_id"
  ]
}

{
  "type": "object",
  "properties": {
    "bounty_status": {
      "type": "string",
      "description": "cancelled."
    },
    "refund": {
      "type": "object",
      "additionalProperties": true,
      "description": "The refund transfer, or absent if the job was never funded.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Payout id (uuid)."
        },
        "bounty_id": {
          "type": "string",
          "description": "The job this payout belongs to."
        },
        "submission_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The submission that triggered it, or null for a refund."
        },
        "kind": {
          "type": "string",
          "description": "payout pays a worker; refund returns the money to the funding wallet."
        },
        "to_address": {
          "type": "string",
          "description": "Wallet that receives the money."
        },
        "chain": {
          "type": "string",
          "description": "Network the transfer was sent on."
        },
        "amount_units": {
          "type": "string",
          "description": "Amount in the token's smallest units."
        },
        "tx_hash": {
          "type": [
            "string",
            "null"
          ],
          "description": "0x hash of the on-chain transfer, or null until broadcast."
        },
        "status": {
          "type": "string",
          "description": "pending | sent | confirmed | failed. failed can be retried with retry_payout."
        },
        "attempts": {
          "type": "number",
          "description": "Broadcast attempts so far."
        },
        "last_error": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why the last attempt failed, or null."
        },
        "created_at": {
          "type": "string",
          "description": "ISO creation time."
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "The job cancelled and the money on its way back."
}

Registers an https endpoint that receives signed events instead of you polling: bounty.claimed, submission.created, payout.confirmed, payout.failed, bounty.refunded. Pass null to remove it. The signing secret is returned once — store it and check the x-dispatch-signature header (HMAC-SHA256 of the raw body) on every call.

{
  "type": "object",
  "properties": {
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "https URL to receive events, or null to remove"
    }
  },
  "required": [
    "url"
  ]
}

{
  "type": "object",
  "properties": {
    "webhook_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "The endpoint now receiving events, or null if removed."
    },
    "webhook_secret": {
      "type": [
        "string",
        "null"
      ],
      "description": "The signing secret, returned once when you set a URL."
    },
    "note": {
      "type": [
        "string",
        "null"
      ],
      "description": "How to verify each delivery."
    }
  },
  "additionalProperties": true,
  "description": "The endpoint now registered and the secret to verify it with."
}

Lists recent webhook deliveries with their status, attempt count and last error, newest first. Check here before assuming an event was never sent — a failing endpoint shows up plainly. Read-only.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "deliveries": {
      "type": "array",
      "description": "Up to 50 recent deliveries.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string",
            "description": "Delivery id."
          },
          "event": {
            "type": "string",
            "description": "Event name, e.g. submission.created."
          },
          "status": {
            "type": "string",
            "description": "pending | sent | failed."
          },
          "attempts": {
            "type": "number",
            "description": "Sends attempted (up to 5)."
          },
          "last_status": {
            "type": [
              "number",
              "null"
            ],
            "description": "HTTP status your endpoint last returned."
          },
          "last_error": {
            "type": [
              "string",
              "null"
            ],
            "description": "Transport error from the last attempt."
          },
          "created_at": {
            "type": "string",
            "description": "ISO time the event was created."
          }
        }
      }
    }
  },
  "additionalProperties": true,
  "description": "Recent deliveries, newest first."
}

Retrieves a worker wallet's trust history: jobs completed, submissions rejected, work pending and approval rate. Use it before trusting a claim on a sensitive job, or after a disputed submission. It is public and read-only, so it can be called freely.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Worker 0x wallet address"
    }
  },
  "required": [
    "address"
  ]
}

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Worker wallet address (lowercase 0x...)."
    },
    "completed": {
      "type": "number",
      "description": "Submissions approved."
    },
    "rejected": {
      "type": "number",
      "description": "Submissions rejected."
    },
    "pending": {
      "type": "number",
      "description": "Submissions still awaiting review."
    },
    "approval_rate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Percent of reviewed submissions that were approved, or null if nothing has been reviewed yet."
    }
  },
  "additionalProperties": true,
  "description": "A worker's on-chain track record."
}