Your company profile
GET/v1/company
scope company.read
The public shop profile, the settings that change how your orders behave, and the countries you sell into. Returns 403 not_a_company for a private seller.
Response#
| Field | Type | Description |
|---|---|---|
company | object | Your public shop profile — what buyers see on your company page. |
company. | integer | Your company id. |
company. | string | The account name. |
company. | string|null | The registered legal name. READ-ONLY here: legal identity is changed through verification, not through this API. |
company. | string|null | The shop name buyers see. |
company. | string|null | Your shop description. May contain HTML. |
company. | string|null | Your logo, once uploaded through POST /v1/company/logo. |
company. | string|null | The cover image on your company page. |
company. | object | Public contact details. |
company. | string|null | Who to ask for. |
company. | string|null | Public email. |
company. | string|null | Public phone. |
company. | string|null | A DISPLAY address only — not where parcels are collected. Pickup points are where that is decided. |
company. | object | Your links. Every one is optional and null when unset. |
company. | string|null | Your own site. |
company. | string|null | Your page on another marketplace. |
company. | string|null | A map link to your shop. |
company. | string|null | Social link. |
company. | string|null | Social link. |
company. | string|null | Social link. |
company. | string|null | Social link. |
company. | string|null | Social link. |
company. | boolean | Whether the company can trade. false means listings are not being shown. |
company. | string|null | ISO-8601 UTC, or null while onboarding is unfinished. |
settings | object | How your company behaves on the marketplace. |
settings. | boolean | Whether buyers may send price offers on your listings. |
settings. | object | Which fees you carry rather than the buyer. |
settings. | boolean | true means YOU pay our commission and the buyer never sees it added. It comes out of your payout instead. |
settings. | boolean | Whether you carry delivery on domestic orders. The per-band detail is on GET /v1/company/shipping-absorption — this is the master switch. |
settings. | boolean | The same for cross-border orders. Separate, because a cross-border parcel can cost more than the product. |
settings. | boolean | true means absorption cannot simply be switched off once it is on. Stated here so an ERP does not offer a toggle that will be refused. |
settings. | object | What you may do with delivery. |
settings. | boolean | Whether your account may use Biklo's couriers at all. false makes shipping.ship_with_us on a product meaningless. |
selling_countries | array | Where you may sell. The same list as GET /v1/company/selling-countries. |
selling_countries[]. | integer | Our internal id. |
selling_countries[]. | string | ISO-2. |
selling_countries[]. | string | The country name. |
selling_countries[]. | string | The currency orders from there settle in. |
Example
{
"company": {
"id": 9000010,
"name": "Example Bikes SL",
"business_name": "Example Bikes SL",
"title": "Example Bikes",
"description": "<p>Mountain bike apparel from Barcelona.</p>",
"logo_url": null,
"cover_url": null,
"contact": {
"person": "Sandbox Contact",
"email": "[email protected]",
"phone": "0700000000",
"address": "Carrer Gran 42, Barcelona"
},
"links": {
"website": "https://example.com",
"marketplace": null,
"google_maps": null,
"facebook": null,
"instagram": null,
"linkedin": null,
"tiktok": null,
"youtube": null
},
"is_active": true,
"onboarding_completed_at": "2026-08-02T09:14:00Z"
},
"settings": {
"allow_price_negotiation": true,
"fees": {
"absorb_platform_fee": false,
"absorb_shipping_local": true,
"absorb_shipping_international": false,
"absorption_is_locked": true
},
"shipping": {
"can_ship_with_us": true
}
},
"selling_countries": [
{
"country_id": 70,
"code": "ES",
"name": "España",
"currency": "EUR"
}
]
}