Skip to content

Market routes: enter

The Market Verbs enter as api.sb routes, with inputs, result, refusals and an example.

Reference for Market, one group of Market routes.

Market.enter

Enter opens a Market to a Startup: Prices in its currency, the Site in its locales, and its floor rows woken. Verb page.

Text
POST /{namespace}/markets/{market}/enter

Path: market. Body, as JSON: the other inputs. Emits Market.entered.

Inputs

InputTypeRequiredDescription
startupStartuprequiredThe Startup that enters.
marketMarketrequiredThe Market to open.

Returns

OutputTypeRequiredDescription
marketMarketrequiredThe Market, now open to the Startup.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X POST https://api.sb/leaseline.app/markets/market_4uFEzN14G4/enter \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"startup":"startup_l3hr1EnUGY"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "market": {
    "$id": "https://api.sb/leaseline.app/markets/market_4uFEzN14G4",
    "$type": "Market",
    "countries": [
      "Example countries"
    ],
    "currency": "USD",
    "locales": [
      "Example locales"
    ]
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Market.enter",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}