Spaceship MCP Connector — Referentie van tools

Spaceship MCP Connector verbindt je AI-assistent (zoals Claude) met je Spaceship-account. Via deze connector kan de assistent de beschikbaarheid en prijzen van domeinen controleren, je links geven om domeinen te kopen op de betaalpagina van Spaceship, domeincontacten en nameservers beheren, DNS-records lezen of bewerken, en namens jou domeinen kopen en verkopen op de Spaceship-marktplaats — je vraagt het gewoon in gewone taal, en de assistent gebruikt de juiste tools.

De assistent brengt nooit kosten in rekening op je account. Het kopen van een domein verloopt altijd via domain_purchase_link: je opent de link en controleert en betaalt daarna zelf op de betaalpagina van Spaceship.

Aan de slag

Je hebt een Spaceship-account nodig. Spaceship MCP Connector is beschikbaar op https://connector-mcp.spaceship.com/mcp.

  • Claude (web en desktop) — open Instellingen, kies Connectors, zoek Spaceship in de connector-directory en voeg het toe. Claude van Anthropic is momenteel de client waarvan we hebben geverifieerd dat Spaceship MCP Connector ermee werkt.

  • Andere MCP-clients — voeg een externe MCP-server toe en laat deze verwijzen naar https://connector-mcp.spaceship.com/mcp. Andere clients werken mogelijk, maar we hebben ze nog niet geverifieerd.

Wanneer je verbinding maakt, wordt je gevraagd om je aan te melden bij Spaceship en de assistent toegang tot je account te geven. Welke tools de assistent kan gebruiken hangt af van de toegang die je goedkeurt — als een tool niet beschikbaar is omdat er geen toegang is verleend, zie Toegang die je verleent, maak dan opnieuw verbinding en keur de toegang goed die nodig is.

Voorwaarden en privacy

De overeenkomsten en beleidsregels die van toepassing zijn op Spaceship MCP Connector en op alles wat je erdoor koopt:

Tools in één oogopslag

  • Tool: contacts_save

    Wat het doet: Contactgegevens opslaan en een contact-ID ophalen

    Toegang: Schrijven

  • Tool: contacts_get

    Wat het doet: Een opgeslagen contact lezen op basis van de ID

    Toegang: Lezen

  • Tool: contacts_list

    Wat het doet: Alle opgeslagen contacten weergeven om er één te vinden en opnieuw te gebruiken

    Toegang: Lezen

  • Tool: domains_list

    Wat het doet: Uw domeinen weergeven of één domein opzoeken

    Toegang: Lezen

  • Tool: domains_check_availability

    Wat het doet: Controleren of domeinen beschikbaar zijn om te registreren, en hun prijs

    Toegang: Lezen

  • Tool: domain_purchase_link

    Wat het doet: Betaallinks ophalen om domeinen te kopen op de betaalpagina van Spaceship — er wordt niets in rekening gebracht door de aanroep

    Toegang: Schrijven

  • Tool: domain_set_contacts

    Wat het doet: Contacten toewijzen aan een domein dat je bezit

    Toegang: Gevoelig schrijven

  • Tool: domain_set_nameservers

    Wat het doet: Een domein overschakelen naar basis- of aangepaste nameservers

    Toegang: Gevoelig schrijven

  • Tool: dns_records_get

    Wat het doet: DNS-records voor een domein lezen

    Toegang: Lezen

  • Tool: dns_records_save

    Wat het doet: DNS-records toevoegen of hun TTL bijwerken

    Toegang: Schrijven

  • Tool: dns_records_delete

    Wat het doet: DNS-records verwijderen

    Toegang: Gevoelig schrijven

  • Tool: async_operation_get

    Wat het doet: De status van een langlopende bewerking controleren

    Toegang: Lezen

  • Tool: marketplace_listings_list

    Wat het doet: De domeinen weergeven die u te koop hebt gezet, met filters

    Toegang: Lezen

  • Tool: marketplace_listing_get

    Wat het doet: Eén vermelding volledig lezen, met de Add to Cart-links

    Toegang: Lezen

  • Tool: marketplace_listing_create

    Wat het doet: Een domein te koop zetten op de Spaceship marketplace

    Toegang: Gevoelig schrijven

  • Tool: marketplace_listing_update

    Wat het doet: De prijzen, beschrijving, pagina-instellingen of Lease-to-Own van een vermelding wijzigen

    Toegang: Gevoelig schrijven

  • Tool: marketplace_listing_delete

    Wat het doet: Een domein uit de verkoop halen — kan niet ongedaan worden gemaakt

    Toegang: Gevoelig schrijven

  • Tool: marketplace_listing_verify

    Wat het doet: Start een eigendomscontrole voor één vermelding die wacht op verificatie

    Toegang: Schrijven

  • Tool: marketplace_listings_bulk_verify

    Wat het doet: Start eigendomscontroles voor elke vermelding die wacht op verificatie

    Toegang: Schrijven

  • Tool: marketplace_seller_settings_get

    Wat het doet: Lees de portfoliopagina, Quality Offer, gemaskeerde uitbetalingsmethoden en verificatierecords

    Toegang: Lezen

  • Tool: marketplace_seller_settings_update

    Wat het doet: Wijzig de portfoliopagina en/of de accountbrede Quality Offer-instelling

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_insights_get

    Wat het doet: Portfolio-, onderhandelings-, verkoop-, verkeers- en omzetcijfers plus de topdomeinen

    Toegang: Lezen

  • Tool: marketplace_sales_list

    Wat het doet: Geeft een lijst van de domeinen die de verkoper heeft verkocht, met prijs en uitbetaling

    Toegang: Lezen

  • Tool: marketplace_checkout_links_list

    Wat het doet: Geeft een lijst van de checkoutlinks van de verkoper met status, prijs en kostenverdeling

    Toegang: Lezen

  • Tool: marketplace_checkout_link_create

    Wat het doet: Maakt een deelbare checkoutlink voor 7 dagen met "nu kopen" voor een vermeld domein

    Toegang: Gevoelig schrijven

  • Tool: marketplace_checkout_link_deactivate

    Wat het doet: Deactiveert na bevestiging definitief een actieve checkoutlink

    Toegang: Gevoelig schrijven

  • Tool: marketplace_negotiations_list

    Wat het doet: Geef je onderhandelingen weer als verkoper of als koper, gefilterd op status of domein

    Toegang: Lezen

  • Tool: marketplace_negotiation_get

    Wat het doet: Lees één onderhandeling met de aanbiedingen en nieuwste berichten

    Toegang: Lezen

  • Tool: marketplace_negotiation_message_send

    Wat het doet: Stuur een tekstbericht naar de andere partij van een onderhandeling

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_offer_make

    Wat het doet: Doe als koper een bod op een domein dat te koop staat

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_offer_counter

    Wat het doet: Doe een tegenbod op het bod van de andere partij met een bedrag of Lease-to-Own-voorwaarden

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_offer_accept

    Wat het doet: Accepteer het meest recente bod van de andere partij — een bindende overeenkomst

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_offer_decline

    Wat het doet: Wijs als verkoper het meest recente bod van de koper af

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_offer_withdraw

    Wat het doet: Trek als verkoper je eigen openstaande tegenbod in

    Toegang: Gevoelig schrijven

  • Tool: marketplace_negotiation_suspend

    Wat het doet: Annuleer (schort op) als verkoper een volledige onderhandeling op je vermelding, na bevestiging

    Toegang: Gevoelig schrijven

  • Tool: marketplace_negotiation_restore

    Wat het doet: Herstel als verkoper een opgeschorte onderhandeling

    Toegang: Schrijven

  • Tool: marketplace_safepay_deals_list

    Wat het doet: Geef je SafePay-deals weer als verkoper, koper of beide, gefilterd op status of domein

    Toegang: Lezen

  • Tool: marketplace_safepay_deal_get

    Wat het doet: Lees één SafePay-deal: voorwaarden, wie wat betaalt, je volgende stap en je link

    Toegang: Lezen

  • Tool: marketplace_safepay_deal_create

    Wat het doet: Open een SafePay-deal voor een domein als verkoper of koper

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_safepay_deal_confirm

    Wat het doet: Bevestig de voorwaarden van een SafePay-deal die door de andere partij is geopend, na een bevestigingsstap

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_leases_list

    Wat het doet: Geef de lease-to-own-overeenkomsten weer die je least of verleast

    Toegang: Lezen

  • Tool: marketplace_lease_get

    Wat het doet: Lees één lease-to-own-overeenkomst: status, betaald, resterend en de volgende betaling

    Toegang: Lezen

  • Tool: marketplace_lease_cancel

    Wat het doet: Een lease-to-own-overeenkomst annuleren als koper, na een bevestigingsstap

    Toegang: Gevoelig schrijven

  • Tool: marketplace_listings_search

    Wat het doet: Zoek domeinen die andere mensen te koop aanbieden op één verplicht trefwoord, verfijnd op TLD, prijs, lengte en optie

    Toegang: Lezen

  • Tool: marketplace_purchase_link

    Wat het doet: Een link ophalen om op Spaceship te betalen voor een marktplaatsdomein, een overeenkomst of een SafePay-deal — de aanroep brengt niets in rekening

    Toegang: Schrijven

  • Tool: marketplace_listings_import

    Wat het doet: Tot 5000 domeinen in één bewerking te koop zetten die na de aanroep wordt uitgevoerd

    Toegang: Gevoelig schrijven

  • Tool: marketplace_listings_bulk_update

    Wat het doet: Prijzen, pagina-instellingen of lease-to-own wijzigen voor veel vermeldingen in één bewerking

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_negotiations_bulk_cancel

    Wat het doet: Annuleert na bevestiging veel onderhandelingen over je aanbiedingen in één bewerking

    Toegang: Gevoelige schrijfactie

  • Tool: marketplace_listings_export

    Wat het doet: Exporteert elke aanbieding naar een CSV-bestand, voorbereid na de aanroep

    Toegang: Lezen

  • Tool: marketplace_sales_export

    Wat het doet: Exporteert de domeinen die tussen twee datums zijn verkocht naar een CSV-bestand, voorbereid na de aanroep

    Toegang: Lezen

Toegang:Lezen haalt alleen informatie op. Schrijven wijzigt gegevens op een manier die je eenvoudig kunt terugdraaien. Gevoelige schrijfactie heeft een effect dat je niet zomaar kunt terugnemen (kost geld, kan niet ongedaan worden gemaakt, verandert onmiddellijk hoe je domein werkt, bereikt een andere persoon of stelt een prijs in waartegen anderen kunnen kopen); je assistent moet je vragen elke aanroep te bevestigen.

Geen van deze tools brengt kosten in rekening op je account. Om een domein te kopen, retourneert domain_purchase_link links die je zelf opent en betaalt, en domains_list bevestigt daarna de uitkomst.

Toegang die je verleent

Wanneer je inlogt, toont Spaceship een toestemmingsscherm dat vraagt welke toegang je de assistent wilt geven. Leestoegang is altijd inbegrepen; schrijftoegang is een aparte keuze. De toegang waarvoor je toestemming geeft, bepaalt welke tools de assistent kan gebruiken:

  • U staat toe: Lezen

    De assistent kan gebruiken: De hierboven als Read gemarkeerde tools: contacts_get, contacts_list, domains_list, domains_check_availability, dns_records_get, async_operation_get, marketplace_listings_list, marketplace_listing_get, marketplace_listings_search, marketplace_seller_settings_get, marketplace_insights_get, marketplace_sales_list, marketplace_checkout_links_list, marketplace_negotiations_list, marketplace_negotiation_get, marketplace_safepay_deals_list, marketplace_safepay_deal_get, marketplace_leases_list, marketplace_lease_get, marketplace_listings_export en marketplace_sales_export.

  • U staat toe: Lezen en schrijven

    De assistent kan gebruiken: Elke tool in de bovenstaande tabel.

  • Schrijftoegang op zichzelf werkt als lezen en schrijven.

  • Een tool die u niet hebt toegestaan, wordt niet aan de assistent getoond, en een aanroep ernaar wordt beantwoord alsof de tool niet bestaat: de JSON-RPC-fout -32602 met het bericht Tool <name> not found. Het antwoord zegt nooit waarom.

  • Met alleen leestoegang krijgt de assistent te horen dat de verbinding alleen accountgegevens kan lezen, en dat hij u moet vragen opnieuw verbinding te maken en schrijfbewerkingen toe te staan wanneer u om iets vraagt dat hij niet kan doen. Als de door u verleende toegang geen enkele tool beschikbaar laat, krijgt hij in plaats daarvan te horen dat de verbinding geen toegang heeft tot accountgegevens, en dat hij u moet vragen opnieuw verbinding te maken en toegang toe te staan. Geen van beide teksten wordt verzonden wanneer schrijftoegang is toegestaan.

  • Een verbinding die is goedgekeurd voordat deze keuze bestond, of die alleen om de basis-Spaceship-toegang vroeg, behoudt toegang tot elke tool. Een wijziging in uw keuze wordt van kracht wanneer de assistent zich de volgende keer aanmeldt of zijn token vernieuwt.

  • Een verbinding zonder bruikbare Spaceship-toegang ziet geen tools.

Contacten: verwezen via ID

Elke tool die een contact nodig heeft, gebruikt een contactId string voor elke rol, nooit inline contactgegevens. Deze tools zijn domain_purchase_link, domain_set_contacts en marketplace_purchase_link.

Sla het contact eerst op met contacts_save, dat de ID ervan retourneert, en geef die ID vervolgens door waar het contact wordt geaccepteerd. Er is geen inline automatisch opslaan; een rol kan geen volledig contactobject ontvangen. U kunt ook een ID hergebruiken uit een resultaat van contacts_list of domains_list.

Een contactId is een string van 27–32 alfanumerieke tekens. Geef deze gewoon terug waar een contact wordt geaccepteerd.

Veelvoorkomende workflows

Verschillende tools zijn ontworpen om samen te worden gebruikt: de uitvoer van de ene wordt de invoer van de volgende.

  1. domains_check_availability — controleer de naam of namen die u wilt. Ga alleen verder wanneer resultavailable is. Elke beschikbare naam bevat de USD-price om deze te registreren (standaard en premium alike), of priceUnavailableReason wanneer deze niet kan worden bepaald, plus minRegisterPeriodInYears en maxRegisterPeriodInYears — de looptijden die de TLD toestaat. Let erop dat de priceprice.pricedYears jaar dekt, wat de kortste door de TLD toegestane looptijd is en niet altijd 1 is.

  2. domain_purchase_link — zodra u akkoord gaat, geeft u de domeinen door als items en de contacten die erop moeten komen als contacts — contact-ID's uit contacts_list, of sla eerst nieuwe gegevens op met contacts_save — met gedeelde years en autoRenew op het hoogste niveau en overrides per domein waar deze verschillen. Deze aanroep brengt niets in rekening. Deze retourneert één link per groep van maximaal 10 domeinen, met een geschatte prijs voor elk; u opent elke link en betaalt op de betaalpagina van Spaceship, waar u de betaalmethode kiest (account funds is vooraf geselecteerd wanneer u die hebt). WHOIS-privacy kan op deze manier niet worden ingesteld.

  3. domains_list — nadat u hebt betaald, roept u dit aan voor het domein om te bevestigen dat het is geregistreerd. Behandel de link niet als bewijs van aankoop, en de assistent mag niet zeggen dat een domein is geregistreerd op basis van het gesprek daarvoor.

Vraag niet om een tweede link voor een aankoop die mogelijk al is geslaagd. Als u mogelijk al voor een domein hebt betaald — u hebt een eerdere link gevolgd, of het op een andere manier gekocht — roep dan eerst domains_list aan en vraag alleen om een nieuwe link voor domeinen die echt niet zijn geregistreerd. Links verlopen niet en kunnen opnieuw worden gebruikt, dus deel ze niet met iemand anders.

De contacten op een domein dat u bezit bijwerken

  1. domain_set_contacts — wijs contacten toe aan het domein via contactId (sla ze indien nodig eerst op met contacts_save). Dit wordt onmiddellijk voltooid en retourneert een verificationStatus: verification betekent dat de registrant zijn e-mailadres moet bevestigen voordat de wijziging volledig wordt toegepast (er wordt een e-mail naar hem verzonden), success betekent dat deze al is bevestigd, en null betekent dat voor dat domein geen bevestiging vereist is.

De nameservers van een domein wijzigen

  1. domains_list — zoek het domein en bekijk de huidige nameservers ({ provider, hosts }).

  2. domain_set_nameservers — schakel het over naar de standaard-nameservers van Spaceship met provider: "basic" (geen hosts), of laat het verwijzen naar uw eigen nameservers met provider: "custom" en een lijst van 2–12 hosts. Dit retourneert de resulterende { provider, hosts }, en een volgende domains_list weerspiegelt de wijziging. Het opnieuw toepassen van de status waarin een domein zich al bevindt, is geen fout: er wordt niets geschreven, en het antwoord bevat de opmerking "Al ingesteld; er is niets gewijzigd.".

DNS-records beheren

  1. domains_list — zoek het domein dat u wilt beheren (of geef de naam direct door als u die kent).

  2. dns_records_get — lees de huidige records voor het domein.

  3. dns_records_save of dns_records_delete — records toevoegen, bijwerken of verwijderen. Records die door dns_records_get worden geretourneerd, hebben dezelfde vorm die de tools voor opslaan en verwijderen accepteren (verwijderen laat alleen ttl weg), zodat de assistent kan lezen, aanpassen en terugschrijven. Matching is niet hoofdlettergevoelig, behalve voor TXT-records, die wel hoofdlettergevoelig zijn.

Uw portfolio bekijken

  • domains_list — blader door al uw domeinen met sortering, of haal één domein op naam op. Elk domein bevat de vervaldatum, instelling voor automatische verlenging, status, nameservers, privacybescherming en toegewezen contact-ID's.

  • contacts_list — blader door alle contacten die in uw account zijn opgeslagen om een bestaand contact te vinden en opnieuw te gebruiken (via de contact-ID) in plaats van een duplicaat te maken.

  • contacts_get — zoek de gegevens op achter elke contact-ID die u op een domein of in een resultaat van contacts_list ziet.

Domeinen verkopen op de marketplace

  1. marketplace_listing_create — zet een domein te koop met een Buy Now-prijs, een minimum bod of beide. Een nieuwe listing is verifying terwijl het eigendom wordt gecontroleerd. Een domein dat bij Spaceship is geregistreerd, wordt meestal binnen ongeveer een minuut te koop gezet; voor een domein dat elders is geregistreerd, publiceert u de DNS-records die worden getoond door marketplace_seller_settings_get en start u daarna een controle met marketplace_listing_verify (of marketplace_listings_bulk_verify voor allemaal).

  2. marketplace_listings_list / marketplace_listing_get — bekijk uw listings; wijzig er één met marketplace_listing_update, of veel tegelijk met marketplace_listings_bulk_update.

  3. marketplace_negotiations_list / marketplace_negotiation_get — volg de biedingen die kopers doen en reageer daarna met marketplace_offer_counter, marketplace_offer_accept (altijd eerst door u bevestigd) of marketplace_offer_decline, en praat met de koper via marketplace_negotiation_message_send.

  4. marketplace_sales_list en marketplace_insights_get — bekijk wat er is verkocht en hoe het portfolio presteert.

  5. marketplace_listings_export / marketplace_sales_export — download uw listings, of wat er tussen twee datums is verkocht, als CSV-bestand.

Een domein kopen op de marketplace

  1. marketplace_listings_search — vind domeinen die andere verkopers aanbieden op basis van één trefwoord, verfijnd op extensie, prijs, lengte en aankoopoptie.

  2. marketplace_offer_make — doe een bod; de verkoper krijgt een melding en er wordt een onderhandeling geopend. Volg deze op met marketplace_negotiation_get.

  3. marketplace_safepay_deal_create — of open een SafePay-deal voor het domein; de andere partij bevestigt de voorwaarden en de koper betaalt via de deallink. De aanroep brengt niets in rekening.

  4. marketplace_purchase_link — betaal ervoor: een Buy Now-domein, een overeenkomst die u hebt bereikt, of een SafePay-deal die op uw betaling wacht. Geef voor een domein of een overeenkomst een van uw opgeslagen contacten (contacts_list) door als contactId; dit wordt het contact van het domein. De aanroep retourneert een link die u opent en waarop u betaalt op Spaceship; de aanroep brengt niets in rekening.

Toolreferentie

Elke tool retourneert het resultaat als gestructureerde JSON. De bulkbewerkingen van de marketplace worden na de aanroep uitgevoerd en retourneren een bewerkingsreferentie om te pollen met async_operation_get; elke andere tool wordt onmiddellijk voltooid.

Contacten

Contacten zijn de personen of organisaties die aan een domeinregistratie zijn gekoppeld (registrant, admin, tech, billing). Naar een contact wordt overal verwezen via de contact-ID — een ondoorzichtige string.

contacts_save — Contact opslaan

Toegang: Schrijven.

Slaat contactgegevens op en retourneert de gegenereerde contact-ID. Validatie van sommige velden (zoals stateProvince en postalCode) hangt af van het geselecteerde land.

Als de aanroep mislukt met infrastructure.serviceUnavailable, kan het contact toch zijn opgeslagen: zoek ernaar met contacts_list voordat u opnieuw opslaat (zie Retrying writes).

  • Parameter: firstName

    Vereist: Ja

    Type & beperkingen: String, 1–64 tekens. Mag koppeltekens en apostroffen bevatten.

  • Parameter: lastName

    Vereist: Ja

    Type & beperkingen: String, 1–64 tekens. Mag koppeltekens en apostroffen bevatten.

  • Parameter: email

    Vereist: Ja

    Type & beperkingen: Geldig e-mailadres, max. 254 tekens.

  • Parameter: address1

    Vereist: Ja

    Type & beperkingen: Adresregel 1. String, 1–128 tekens.

  • Parameter: city

    Vereist: Ja

    Type & beperkingen: String, 1–64 tekens.

  • Parameter: country

    Vereist: Ja

    Type & beperkingen: Landcode van twee letters (ISO 3166-1 alpha-2), bijv. US.

  • Parameter: phone

    Vereist: Ja

    Type & beperkingen: Internationaal formaat +CountryCode.Number, bijv. +1.2025551234. Max. 32 tekens.

  • Parameter: organization

    Vereist: Nee

    Type & beperkingen: Naam van organisatie/bedrijf. 1–128 tekens.

  • Parameter: address2

    Vereist: Nee

    Type & beperkingen: Adresregel 2. 1–128 tekens.

  • Parameter: stateProvince

    Vereist: Nee

    Type & beperkingen: Naam van staat/provincie, 1–64 tekens. Kan verplicht zijn afhankelijk van het land.

  • Parameter: postalCode

    Vereist: Nee

    Type & beperkingen: 1–16 tekens. Kan verplicht zijn afhankelijk van het land.

  • Parameter: phoneExt

    Vereist: Nee

    Type & beperkingen: Telefoontoestelnummer, 1–16 tekens.

  • Parameter: fax

    Vereist: Nee

    Type & beperkingen: Faxnummer, hetzelfde formaat +CountryCode.Number, max. 32 tekens.

  • Parameter: faxExt

    Vereist: Nee

    Type & beperkingen: Faxtoestelnummer, 1–16 tekens.

  • Parameter: taxNumber

    Vereist: Nee

    Type & beperkingen: Belastingnummer, 1–32 tekens.

Retourneert

{ "contactId": "..." }

contactId (27–32 alfanumerieke tekens) is wat je doorgeeft aan domain_purchase_link, domain_set_contacts en contacts_get.

contacts_get — Contact ophalen

Toegang: Lezen.

Leest de gegevens van een opgeslagen contact op basis van de contact-ID. Contact-ID's komen van contacts_save, contacts_list of het veld contacts van de resultaten van domains_list.

  • Parameter: contactId

    Vereist: Ja

    Type & beperkingen: Contact-ID, 27–32 alfanumerieke tekens.

Retourneert — { contact } met:

  • Veld: firstName, lastName, email, address1, city, country, phone, postalCode

    Type: String

  • Veld: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber

    Type: String of null

contacts_list — Contacten weergeven

Toegang: Lezen.

Geeft alle contacten weer die onder je account zijn opgeslagen, zodat je een bestaand contact kunt vinden en hergebruiken (via de contact-ID) in plaats van een duplicaat te maken of door je domeinen te moeten zoeken. De lijst is gepagineerd en sorteerbaar, consistent met domains_list.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Items per pagina, 1–100. Standaard 10.

  • Parameter: skip

    Vereist: Nee

    Type & beperkingen: Over te slaan items, 0 of meer. Standaard 0.

  • Parameter: orderBy

    Vereist: Nee

    Type & beperkingen: Maximaal 8 sorteersleutels: name, email, organization; voorzie van - voor aflopend sorteren (bijv. -name).

Retourneert — { items, total } waarbij total het aantal unieke contacten op het account is (ontdubbeld op contact-ID, niet de paginagrootte), en elk item genoeg informatie bevat om contacten van elkaar te onderscheiden zonder een vervolgaanroep. Als het account dubbele vermeldingen voor dezelfde contact-ID heeft, worden die samengevoegd tot één, zodat total afzonderlijke contacten telt in plaats van ruwe server-side rijen:

  • Veld: contactId

    Type: String (27–32 alfanumeriek). Doorgeven aan contacts_get, domain_purchase_link of domain_set_contacts.

  • Veld: name

    Type: String — de naam van het contact.

  • Veld: email

    Type: String of null wanneer er geen e-mailadres voor het contact is geregistreerd.

  • Veld: organization

    Type: String of null wanneer er geen organisatie voor het contact is geregistreerd.

{
"items": [
{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }
],
"total": 1
}

Domeinen

Invoer voor domeinnamen (domain/domainName) accepteert Unicode (IDN) of ASCII (A-label) — in beide gevallen normaliseert de tool de naam automatisch naar punycode vóór gebruik. domains_check_availability vereist daarnaast een TLD die Spaceship ondersteunt voor registratie: een domein waarvan de TLD niet wordt ondersteund, wordt als niet beschikbaar gerapporteerd in plaats van gecontroleerd. De andere domeintools (domains_list, domain_set_contacts, domain_set_nameservers) en de DNS-tools normaliseren alleen de naam en weigeren nooit op basis van TLD-ondersteuning.

domains_list — Domeinen weergeven

Toegang: Lezen.

Haalt een gepagineerde lijst van je domeinen op. Geef domain door om in plaats daarvan één enkel domein op naam op te halen (paginering en sortering worden dan genegeerd, en het resultaat bevat een note die dat vermeldt als ze zijn meegegeven). Een domein dat niet in je account staat, of het nu niet geregistreerd is of door iemand anders is geregistreerd, is geen fout: het resultaat is { "items": [], "total": 0, "note": "This domain is not in this account." }, in beide gevallen hetzelfde.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: Volledig gekwalificeerde domeinnaam om één enkel domein op te halen. Accepteert Unicode (IDN) of ASCII (A-label) — automatisch genormaliseerd naar punycode.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Items per pagina, 1–100. Standaard 10.

  • Parameter: skip

    Vereist: Nee

    Type & beperkingen: Over te slaan items, 0 of meer. Standaard 0.

  • Parameter: orderBy

    Vereist: Nee

    Type & beperkingen: Maximaal 4 sorteersleutels, elk één van name, -name, unicodeName, -unicodeName, registrationDate, -registrationDate, expirationDate, -expirationDate; een voorloopteken - betekent aflopend. De eerste sleutel sorteert eerst en elke volgende sleutel verbreekt gelijke waarden. Elk veld mag slechts één keer voorkomen, in welke richting dan ook. Elke andere waarde, of een herhaald veld, wordt afgewezen met application.request.badRequest.

Retourneert — { items, total } waarbij elk item een domein beschrijft:

  • Veld: name / unicodeName

    Betekenis: Domeinnaam in ASCII- en Unicode-vorm.

  • Veld: isPremium

    Betekenis: Of het domein een premiumnaam is.

  • Veld: autoRenew

    Betekenis: Of automatisch verlengen is ingeschakeld.

  • Veld: registrationDate / expirationDate

    Betekenis: Tijdstempels van registratie en vervaldatum.

  • Veld: lifecycleStatus

    Betekenis: creating, registered, grace1, grace2 of redemption.

  • Veld: verificationStatus

    Betekenis: verification, success, failed of null wanneer niet van toepassing.

  • Veld: eppStatuses

    Betekenis: Statuscodes van de registry (bijv. transfervergrendelingen).

  • Veld: suspensions

    Betekenis: Actieve opschortingen, elk met een reasonCode.

  • Veld: privacyProtection

    Betekenis: { level: "public" | "high", contactForm: boolean }.

  • Veld: nameservers

    Betekenis: { provider: "basic" | "custom", hosts: [...] }.

  • Veld: contacts

    Betekenis: Contact-ID's: registrant, plus admin/tech/billing (kan null zijn) en attributes (een lijst met contact-ID's van uitgebreide attributen, of null). Leesbaar via contacts_get.

Spaceship MCP Connector vult elk veld hierboven in — inclusief contacts, eppStatuses, suspensions, verificationStatus, nameservers, een echte autoRenew en een afzonderlijke unicodeName waar het domein die heeft — zowel voor lijsten met meerdere items als voor het ophalen van één enkel domein.

domains_check_availability — Beschikbaarheid van domein controleren

Toegang: Lezen.

Controleert of één of meer domeinnamen beschikbaar zijn om te registreren. Namen worden gecontroleerd in groepen van maximaal 5, een paar groepen tegelijk; een groep met één naam gebruikt het endpoint voor één domein en een grotere groep het bulk-endpoint. Een domein waarvan de TLD niet wordt ondersteund voor registratie wordt helemaal niet naar de beschikbaarheidscontrole gestuurd — het wordt direct geretourneerd als tldNotSupported.

  • Parameter: domains

    Vereist: Ja

    Type & beperkingen: 1–20 volledig gekwalificeerde domeinnamen. Elke naam accepteert Unicode (IDN) of ASCII (A-label) — automatisch genormaliseerd naar punycode.

Retourneert — { results }, één item per opgevraagde naam:

  • Veld: domain

    Betekenis: De gecontroleerde naam.

  • Veld: result

    Betekenis: available, taken, invalidDomainName, tldNotSupported, unexpectedError of checkTimedOut.

  • Veld: premiumPricing

    Betekenis: Voor premiumnamen: lijst van { operation, price, currency } waarbij operationregister, transfer, renew of restore is. Leeg voor gewone namen.

  • Veld: price

    Betekenis: Voor available namen (standaard en premium): de prijs in USD om het domein te registreren voor de kortste termijn die de TLD toestaat — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount is het te betalen totaal voor die volledige termijn; pricedYears geeft aan hoeveel jaar het dekt. Er wordt geen prijs vóór korting of "was"-prijs gerapporteerd. icannFee is de ICANN-vergoeding (USD) die al is inbegrepen in amount, afzonderlijk geretourneerd zodat de uitsplitsing kan worden toegelicht; deze verschijnt alleen wanneer de TLD een vergoeding heeft.

  • Veld: pricePerYear

    Betekenis: Binnen price: amount gedeeld door pricedYears, zodat er altijd een jaarbedrag beschikbaar is voor vergelijking. Wanneer pricedYears 1 is, is het de echte prijs voor één jaar; daarboven is het een gemiddeld bedrag per jaar van de termijn, niet een termijn die je kunt kopen.

  • Veld: minRegisterPeriodInYears / maxRegisterPeriodInYears

    Betekenis: Voor available namen: de kortste en langste registratieperiode die die TLD daadwerkelijk toestaat, als twee gewone getallen. Ze vertellen de klant voor welke termijnen het domein kan worden gekocht. Beide worden weggelaten wanneer de toegestane periode niet kon worden bepaald.

  • Veld: priceUnavailableReason

    Betekenis: Aanwezig in plaats van price wanneer de prijs voor een beschikbare naam niet kon worden bepaald. De controle zelf slaagt nog steeds.

Alleen beschikbare namen krijgen een prijs; taken/ongeldige resultaten bevatten noch price noch priceUnavailableReason.

taken zegt alleen dat de naam geregistreerd is, niet door wie: het domein kan al in je eigen account staan. Controleer eerst domains_list voordat je de klant vertelt dat iemand anders de eigenaar is.

checkTimedOut betekent dat de controle voor die naam niet op tijd is afgerond, dus er is niets over bekend — het is niettaken en niet available. Het bevat geen price. Namen worden in groepen gecontroleerd, en alleen de namen van een groep waarvoor de tijd verstreek komen zo terug; de andere resultaten zijn geldig. Controleer later alleen de namen met checkTimedOut opnieuw. De aanroep mislukt alleen met een fout wanneer elke groep een time-out had, of wanneer een groep om een andere reden mislukt.

De meeste TLD's staan één jaar toe, maar sommige niet..ai heeft bijvoorbeeld een minimum van twee jaar. Voor die gevallen is price.amount het totaal voor de minimumtermijn — niet een prijs voor één jaar waarop je kunt handelen — en price.pricedYears geeft dat aan:

{
"domain": "example.ai",
"result": "available",
"premiumPricing": [],
"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },
"minRegisterPeriodInYears": 2,
"maxRegisterPeriodInYears": 10
}

pricePerYear is hier aanwezig — 159.96 gedeeld door de twee jaar die het dekt geeft 79.98. Dit is het totaal gedeeld door de termijn, niet een prijs die je voor één enkel jaar zou kunnen betalen (een registratie van .ai voor één jaar kan niet worden gekocht). Toon altijd amount samen met pricedYears ("$159.96 voor 2 jaar"), nooit amount alleen. Voor een gewone TLD is pricedYears1 en is pricePerYear gelijk aan amount.

Toegang: Schrijven.

Bereidt één of meer betaallinks van Spaceship voor, zodat je domeinen kunt kopen op de eigen betaalpagina van Spaceship in je browser in plaats van in de chat. Er wordt niets geregistreerd of in rekening gebracht door deze aanroep — je controleert en betaalt op de pagina, wat de bevestigingsstap is. Het is de enige manier om een domein via de assistent te kopen. Vereist de toegang domains:billing. Als je mogelijk al voor een domein hebt betaald, controleer dan eerst domains_list en vraag alleen een link aan voor domeinen die echt niet geregistreerd zijn, anders loop je het risico dubbel te betalen.

Instellingen die op het hoogste niveau zijn opgegeven (years, autoRenew, contacts) zijn van toepassing op elk item. Een item dat zijn eigen years, autoRenew of contacts instelt, overschrijft die alleen voor dat domein, en alles wat het weglaat wordt overgenomen (de contacts van een item vervangen de contacts op het hoogste niveau als geheel). De contacts op het hoogste niveau zijn vereist: de contacten gaan mee met de link en zijn al ingevuld als de contacten van het domein wanneer je die opent. Elk domein mag slechts één keer worden vermeld, en er zijn geen invoervelden voor betaling, valuta of WHOIS-privacy — WHOIS-privacy blijft op de platformstandaard op de betaalpagina.

  • Parameter: items

    Vereist: Ja

    Type & beperkingen: Array van 1–20 items, elk één keer vermeld.

  • Parameter: items[].domain

    Vereist: Ja

    Type & beperkingen: Volledig gekwalificeerde domeinnaam om te kopen, bijv. example.com. Accepteert Unicode (IDN) of ASCII (A-label) — automatisch genormaliseerd naar punycode.

  • Parameter: items[].years

    Vereist: Nee

    Type & beperkingen: Geheel getal 1–10; overschrijft de years op het hoogste niveau voor dit domein.

  • Parameter: items[].autoRenew

    Vereist: Nee

    Type & beperkingen: Boolean; overschrijft de autoRenew op het hoogste niveau voor dit domein.

  • Parameter: items[].contacts

    Vereist: Nee

    Type & beperkingen: Contacten alleen voor dit domein, als contactId-strings (registrant, admin, tech, billing, optioneel attributes); vervangen de contacts op het hoogste niveau als geheel.

  • Parameter: years

    Vereist: Nee

    Type & beperkingen: Geheel getal 1–10, toegepast op elk item dat geen eigen waarde instelt. Moet binnen de termijn vallen die de TLD toestaat (minRegisterPeriodInYears/maxRegisterPeriodInYears uit domains_check_availability); waarden buiten het bereik worden afgewezen met een foutmelding waarin het toegestane bereik wordt genoemd, niet aangepast. Wanneer noch dit noch het item dit instelt, wordt de kortste termijn van de TLD gebruikt.

  • Parameter: autoRenew

    Vereist: Nee

    Type & beperkingen: Booleaans, toegepast op elk item dat geen eigen waarde instelt. Standaard ingesteld op true.

  • Parameter: contacts

    Vereist: Ja

    Type & beperkingen: Contacten als contactId-strings, toegepast op elk item dat geen eigen waarde instelt: registrant (vereist), admin, tech en billing (elk standaard ingesteld op registrant), en optioneel attributes (een lijst van maximaal 5 contact-ID's voor uitgebreide attributen, alleen vereist voor bepaalde TLD's). Neem de ID's uit contacts_list, of sla de gegevens eerst op met contacts_save.

Links per aanroep. Eén link bevat maximaal 10 domeinen, dus een langere lijst geeft meerdere links terug in de volgorde van het verzoek — bijvoorbeeld 15 domeinen leveren twee links op van 10 en 5. links[].domains geeft aan welke domeinen elke link dekt.

Prijs. Het veld price van elk domein is een schatting; de betaalpagina toont de definitieve prijs. Wanneer er geen schatting beschikbaar is, heeft het domein in plaats daarvan het veld priceUnavailableReason. Een ontbrekende schatting verhindert nooit dat een link wordt uitgegeven.

Betaling. De betaalmethode wordt op de pagina gekozen. Rekeningtegoed is vooraf geselecteerd wanneer het account daarover beschikt.

Links zijn herbruikbaar. Een link verloopt niet en kan meer dan één keer worden geopend, dus deel deze niet met iemand anders.

Retourneert

{
"status": "links_ready",
"links": [
{
"url": "https://example.spaceship.com/pay/abc123",
"domains": [
{
"domain": "example.com",
"years": 1,
"autoRenew": true,
"price": { "amount": 9.08, "currency": "USD", "pricedYears": 1, "pricePerYear": 9.08, "icannFee": 0.2, "isPremium": false }
},
{
"domain": "example.ai",
"years": 2,
"autoRenew": false,
"priceUnavailableReason": "Price is currently unavailable for this domain."
}
]
}
],
"failed": [],
"note": "Nothing has been charged. ..."
}

  • status: links_ready

    Betekenis: Elk domein wordt door een link gedekt.

  • status: partial

    Betekenis: Sommige domeinen worden gedekt; de rest staat vermeld in failed, elk met een reason (bijvoorbeeld niet beschikbaar, niet-ondersteunde extensie, termijn niet toegestaan, probleem met contacten of een link die niet kon worden aangemaakt).

  • status: no_links

    Betekenis: Er is geen link uitgegeven en er is niets in rekening gebracht; failed geeft voor elk domein aan waarom. Wanneer elk domein niet beschikbaar is (al geregistreerd of bezet) of een extensie heeft die hier niet kan worden geregistreerd, is dit een normaal resultaat en wordt het niet als fout gemarkeerd: vertel de klant dat er niets te kopen is. Wanneer een link om een andere reden, of om een combinatie van redenen, niet kon worden voorbereid of aangemaakt, wordt het resultaat als fout gemarkeerd (isError), met dezelfde body.

Nadat de klant zegt dat hij heeft betaald, roep domains_list aan voor het domein om te bevestigen dat het is geregistreerd — beschouw de link alleen niet als aankoopbewijs.

domain_set_contacts — Domeincontacten instellen

Toegang: Gevoelig schrijven — het wijzigen van de eigenaar kan overdrachten 60 dagen blokkeren.

Wijzigt de contacten die zijn toegewezen aan een domein dat u bezit. Wordt onmiddellijk voltooid (geen bewerking om te pollen).

  • Parameter: domainName

    Vereist: Ja

    Type & beperkingen: Volledig gekwalificeerde domeinnaam. Accepteert Unicode (IDN) of ASCII (A-label) — automatisch genormaliseerd naar punycode.

  • Parameter: registrant

    Vereist: Ja

    Type & beperkingen: contactId-string (27–32 alfanumeriek), uit contacts_save.

  • Parameter: admin

    Vereist: Nee

    Type & beperkingen: contactId-string (27–32 alfanumeriek) of null.

  • Parameter: tech

    Vereist: Nee

    Type & beperkingen: contactId-string (27–32 alfanumeriek) of null.

  • Parameter: billing

    Vereist: Nee

    Type & beperkingen: contactId-string (27–32 alfanumeriek) of null.

  • Parameter: attributes

    Vereist: Nee

    Type & beperkingen: Array van contact-ID's voor uitgebreide attributen (maximaal 5); alleen vereist voor bepaalde TLD's, anders weglaten of null gebruiken.

Retourneert

{ "verificationStatus": "verification" }

De geretourneerde verificationStatus weerspiegelt ICANN RAA-e-mailverificatie: verification — de registrant moet zijn e-mailadres bevestigen (er wordt een bevestigingsmail verzonden); success — al bevestigd; null — RAA-verificatie is niet van toepassing op dit domein.

domain_set_nameservers — Nameservers voor domein instellen

Toegang: Gevoelig schrijven — verplaatst al het verkeer van het domein.

Wijzigt de nameservers op registrarniveau van een domein. Wordt onmiddellijk voltooid (geen bewerking om te pollen). De wijziging wordt daarna weergegeven door domains_list.

  • Parameter: domainName

    Vereist: Ja

    Type & beperkingen: Volledig gekwalificeerde domeinnaam. Accepteert Unicode (IDN) of ASCII (A-label) — automatisch genormaliseerd naar punycode.

  • Parameter: provider

    Vereist: Ja

    Type & beperkingen: basic (de standaard nameservers van Spaceship) of custom (uw eigen hosts).

  • Parameter: hosts

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer providercustom is: 2–12 hostnamen van nameservers (elk een geldige FQDN, 4–255 tekens). Moet worden weggelaten wanneer providerbasic is.

Retourneert

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }

Vragen naar de nameservers die een domein al gebruikt, is geen fout. De tool leest eerst de huidige nameservers van het domein. Wanneer die al overeenkomen met het verzoek (dezelfde provider en, voor aangepaste nameservers, dezelfde hosts in willekeurige volgorde en lettergrootte), wordt er niets geschreven en is het antwoord de huidige status met een opmerking:

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"], "note": "Already set; nothing changed." }

Als de huidige nameservers niet op tijd kunnen worden gelezen, wordt de wijziging verzonden zoals gevraagd, en kan een nieuwe toepassing daarna nog steeds worden geweigerd met business.conflict ("These nameservers are already set for this domain."), wat ook betekent dat er niets is gewijzigd.

DNS-records

De domainName die deze tools gebruiken accepteert Unicode (IDN) of ASCII (A-label) en wordt automatisch genormaliseerd naar punycode; ondersteuning voor TLD's wordt hier niet afgedwongen.

dns_records_get — DNS-records ophalen

Toegang: Lezen.

Haalt een gepagineerde lijst met DNS-resource-records voor een domein op.

  • Parameter: domainName

    Vereist: Ja

    Type & beperkingen: Het domein waarvan de records moeten worden opgehaald.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Items per pagina, 1–500. Standaard 100.

  • Parameter: skip

    Vereist: Nee

    Type & beperkingen: Over te slaan items, 0 of meer. Standaard 0.

  • Parameter: orderBy

    Vereist: Nee

    Type & beperkingen: Maximaal 8 sorteersleutels: type, -type, name, -name.

Retourneert — { items, total }. Elk item is een record zoals beschreven in Recordvormen, plus een optioneel veld group dat aangeeft waar het record vandaan komt (custom — door u aangemaakt, product — beheerd door een Spaceship-product, personalNs — persoonlijke nameservers).

dns_records_save — DNS-records opslaan

Toegang: Schrijven.

Voegt aangepaste DNS-records toe of werkt de TTL van bestaande records bij. Records worden hoofdletterongevoelig gematcht, behalve TXT-records (hoofdlettergevoelig).

Als de aanroep mislukt met infrastructure.serviceUnavailable, zijn de records mogelijk toch opgeslagen: lees ze met dns_records_get voordat u opnieuw opslaat (zie Schrijfbewerkingen opnieuw proberen).

  • Parameter: domainName

    Vereist: Ja

    Type & beperkingen: Het domein waarvan de records moeten worden bijgewerkt.

  • Parameter: records

    Vereist: Ja

    Type & beperkingen: 1–500 records — zie Recordvormen. Elk record kan een optionele ttl bevatten.

  • Parameter: force

    Vereist: Nee

    Type & beperkingen: Booleaans. Slaat de controle op conflictoplossing over en forceert de zone-update.

Retourneert — { "saved": <number> }, het aantal ingediende records. Een succesvol antwoord betekent dat alle records zijn geaccepteerd; als een record mislukt, retourneert de hele aanroep in plaats daarvan een fout. Een record dat door de DNS-service wordt afgewezen, laat de aanroep mislukken met business.invalidArgument en het detail "The service rejected the request.", met een validationErrors-vermelding per afgewezen recordveld, zoals { "field": "records.address", "rule": "pattern", "message": "The format of this field is not valid." }. Het veld field noemt het recordveld onder records maar niet welk record in de lijst, dus controleer de waarde van dat veld voor elk record aan de hand van Recordvormen voordat u opnieuw opslaat.

dns_records_delete — DNS-records verwijderen

Toegang: Gevoelig schrijven — verwijderingen kunnen niet ongedaan worden gemaakt.

Verwijdert aangepaste DNS-records. Verwijderingen kunnen niet ongedaan worden gemaakt. Een ingediend record wordt alleen verwijderd wanneer het op elk veld overeenkomt met een opgeslagen record; de regels staan onder de tabel vermeld.

  • Parameter: domainName

    Vereist: Ja

    Type & beperkingen: Het domein waarvan de records moeten worden verwijderd.

  • Parameter: records

    Vereist: Ja

    Type & beperkingen: 1–500 te verwijderen records — dezelfde vormen als bij opslaan, maar zonder ttl. Een record dat niet in de zone staat, wordt gerapporteerd in notFound, niet als fout.

Retourneert — { "deleted": <number>, "notFound": [...] }. deleted is het aantal records dat bestond en is verwijderd. notFound is alleen aanwezig wanneer sommige ingediende records niet in de zone stonden; het somt ze op zoals ingediend, in volgorde, elk één keer. Die records zijn niet verwijderd en dat is geen fout — er is niets om opnieuw te proberen:

{
"deleted": 1,
"notFound": [
{ "type": "TXT", "name": "_old", "value": "v=old" }
]
}

Elk ingediend record dat bestaat, wordt verwijderd, zelfs wanneer andere ontbreken. De tool leest eerst de zone, tot 10.000 records en binnen een tijdslimiet. Wanneer de zone groter is dan dat, of niet binnen de tijdslimiet kan worden gelezen, kan niet worden bevestigd dat een niet-gevonden record afwezig is: het wordt nog steeds ter verwijdering verzonden, en het antwoord is { "deleted": <number>, "unconfirmed": [...], "note": "..." } in plaats van notFound. deleted telt dan alleen de records die in de zone zijn bevestigd. Roep dns_records_get aan om de records in unconfirmed te controleren voordat u opnieuw verwijdert.

Hoe records worden gematcht — een ingediend record komt overeen met een opgeslagen record wanneer het type en elk veld gelijk zijn na normalisatie: namen en hostwaarden (name, cname, aliasName, nameserver, pointer, exchange, SRV- en HTTPS/SVCB-doelen) worden hoofdletterongevoelig vergeleken en negeren één afsluitende punt; de CAA-value is hoofdletterongevoelig en negeert omhullende aanhalingstekens; de TXT-value wordt exact vergeleken, teken voor teken. De MX-preference maakt deel uit van de overeenkomst, dus het verwijderen van mail.example.com met voorkeur 10 verwijdert nooit dezelfde exchange die met een andere voorkeur is opgeslagen. Er is geen prefix- of wildcardmatching, en een veld dat slechts aan één kant aanwezig is, komt niet overeen.

Recordvormen

Elk record heeft:

  • type — een van de 13 ondersteunde typen hieronder.

  • name — de recordnaam met uitzondering van het domein: gebruik @ voor het domein zelf (apex) en * voor een wildcard.

  • ttl (alleen opslaan, optioneel) — cachetijd in seconden, 60–3600.

Typespecifieke velden:

  • Type: A

    Velden: address — IPv4-adres.

  • Type: AAAA

    Velden: address — IPv6-adres.

  • Type: CNAME

    Velden: cname — canonieke domeinnaam (max. 253 tekens).

  • Type: ALIAS

    Velden: aliasName — canonieke domeinnaam; CNAME-achtig gedrag voor de apex, waar CNAME niet is toegestaan.

  • Type: NS

    Velden: nameserver — naam van de nameserver.

  • Type: PTR

    Velden: pointer — domeinnaam voor het opgegeven IP-adres.

  • Type: TXT

    Velden: value — tekstwaarde (hoofdlettergevoelig gematcht).

  • Type: MX

    Velden: exchange — mailserver; preference — prioriteit (0–65535, lager heeft de voorkeur).

  • Type: CAA

    Velden: flag — 0 of 128 (kritieke bit); tag — issue, issuewild, of iodef; value — CA-identificatie met optionele parameters.

  • Type: SRV

    Velden: service (bijv. _sip); protocol (bijv. _tcp); priority en weight (0–65535); port (1–65535); target — serverdomeinnaam.

  • Type: TLSA

    Velden: usage, selector, matching (elk 0–255); port — * of _<1–65535>; protocol (bijv. _tcp); associationData — certificaathash of gegevens.

  • Type: HTTPS

    Velden: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN of .; optioneel port (* of _<1–65535>), scheme (moet _https zijn wanneer port is ingesteld), svcParams.

  • Type: SVCB

    Velden: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN of .; optioneel port, scheme (bijv. _tcp), svcParams.

Marketplace: vermeldingen

Je vermeldingen op de Spaceship marketplace: de domeinen die je te koop hebt gezet, hun prijzen, pagina-instellingen en eigendomsverificatie.

marketplace_listings_list — Mijn marketplace-vermeldingen weergeven

Toegang: Lezen.

Geeft de huidige vermeldingen van je account op de Spaceship marketplace weer — de vermeldingen die je ziet op het tabblad SellerHub Domains — één pagina tegelijk, in een stabiele volgorde. Verkochte, geleasede en mislukte records worden weggelaten tenzij status erom vraagt. Elk item bevat het domein, de status, de prijzen voor Nu kopen en minimum bod, de instellingen voor de For Sale Page, Contact Owner en Quality Offer, en de Lease-to-Own-voorwaarden. Gebruik voor de volledige kaart van één vermelding, inclusief de status van de For Sale Page en Add to Cart-links, marketplace_listing_get.

Alle filters zijn optioneel en worden gecombineerd met AND. Een filter dat niets oplevert is geen fout: het antwoord is een lege items-lijst met total0. Op naamlengte en "Lease-to-Own ingeschakeld" kan niet worden gefilterd.

  • Parameter: status

    Vereist: Nee

    Type en beperkingen: 1–9 verschillende statussen: verifying, on_sale, sale_stopped, private_sale, sale_processing, waiting_for_transfer, on_lease, sold, failed (zie de tabel hieronder). Alleen vermeldingen in een van deze statussen worden geretourneerd. Laat dit weg voor de huidige vermeldingen, zoals het tabblad SellerHub Domains ze toont: verifying, on_sale, sale_stopped, private_sale, sale_processing en waiting_for_transfer na een verkoop; records met on_lease, sold en failed worden alleen geretourneerd wanneer hierom hier wordt gevraagd.

  • Parameter: tld

    Vereist: Nee

    Type en beperkingen: 1–20 verschillende extensies zonder de voorafgaande punt, bijv. ["com", "io"]. Kleine ASCII-letters, cijfers en koppeltekens; extensies met meerdere labels zoals co.uk zijn toegestaan.

  • Parameter: buyNowEnabled

    Vereist: Nee

    Type en beperkingen: Booleaans. true: alleen vermeldingen met Nu kopen aan; false: alleen vermeldingen met Nu kopen uit.

  • Parameter: buyNowPrice.min

    Vereist: Voorwaardelijk

    Type en beperkingen: Getal, 0–10.000.000 Amerikaanse dollar, inclusief. Wanneer buyNowPrice is ingesteld, geef dan de ondergrens, de bovengrens of beide op. De ondergrens mag niet groter zijn dan de bovengrens.

  • Parameter: buyNowPrice.max

    Vereist: Voorwaardelijk

    Type en beperkingen: Getal, 0–10.000.000 Amerikaanse dollar, inclusief.

  • Parameter: minOfferEnabled

    Vereist: Nee

    Type en beperkingen: Booleaans. true: alleen vermeldingen die biedingen accepteren; false: alleen vermeldingen die dat niet doen.

  • Parameter: minOfferPrice.min

    Vereist: Voorwaardelijk

    Type en beperkingen: Getal, 0–10.000.000 Amerikaanse dollar, inclusief. Wanneer minOfferPrice is ingesteld, geef dan de ondergrens, de bovengrens of beide op. De ondergrens mag niet groter zijn dan de bovengrens.

  • Parameter: minOfferPrice.max

    Vereist: Voorwaardelijk

    Type en beperkingen: Getal, 0–10.000.000 Amerikaanse dollar, inclusief.

  • Parameter: limit

    Vereist: Nee

    Type en beperkingen: Vermeldingen per pagina, 1–100. Standaard 25.

  • Parameter: offset

    Vereist: Nee

    Type en beperkingen: Vermeldingen om over te slaan vóór de pagina, 0 of meer. Standaard 0.

Retourneert — { items, total, offset, limit }. total is het aantal vermeldingen dat overeenkomt met de filters over alle pagina's heen. Elk item heeft dezelfde velden als de vermelding in marketplace_listing_get, zonder forSalePageStatus, cartLinks, unavailable en note:

{
"items": [
{
"listingId": "8f3c2a1e-4b5d-4e6f-9a7b-1c2d3e4f5a6b",
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"portfolioEligible": true,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z"
}
],
"total": 1,
"offset": 0,
"limit": 25
}

  • status: verifying

    Betekenis: Het eigendom van het domein wordt gecontroleerd; kopers zien het niet. Een bij Spaceship geregistreerd domein verlaat deze status meestal binnen ongeveer een minuut; een elders geregistreerd domein blijft hier totdat de DNS-verificatierecords zijn gepubliceerd en de controle slaagt.

  • status: on_sale

    Betekenis: Te koop voor kopers.

  • status: sale_stopped

    Betekenis: Vermeld, maar de verkoop is gestopt.

  • status: private_sale

    Betekenis: Wordt verkocht in een privéverkoop.

  • status: sale_processing

    Betekenis: De bestelling van een koper wordt verwerkt.

  • status: waiting_for_transfer

    Betekenis: Verkocht of geleased, wachtend op de overdracht aan de koper.

  • status: on_lease

    Betekenis: Geleased aan een koper.

  • status: sold

    Betekenis: De verkoop is voltooid.

  • status: failed

    Betekenis: De verkoop is mislukt.

marketplace_listing_get — Eén marketplace-vermelding ophalen

Toegang: Lezen.

Leest één van de marketplace-vermeldingen van je account op domein, met de volledige context: status, prijzen voor Nu kopen en minimum bod, beschrijving, de For Sale Page (aan of uit, en de huidige status), Contact Owner, tonen op portfolio, de Quality Offer van het domein, de Lease-to-Own-voorwaarden en de Add to Cart-links (Nu kopen en Lease-to-Own) die je op je eigen site kunt plaatsen; elke link wordt alleen gegeven wanneer kopers die kunnen gebruiken.

De Add to Cart-links worden afzonderlijk gelezen binnen een korte tijdslimiet. Wanneer ze niet op tijd kunnen worden gelezen, is cartLinksnull, noemt unavailablecart_links, en wordt de rest van de vermelding nog steeds geretourneerd; lees later opnieuw voor de links. Een vermelding waarvan het eigendom nog niet is geverifieerd heeft status verifying en een note: een bij Spaceship geregistreerd domein gaat meestal binnen ongeveer een minuut in de verkoop, en een elders geregistreerd domein heeft de verificatierecords nodig in marketplace_seller_settings_get. Een domein dat je account niet heeft vermeld antwoordt met business.notFound.

  • Parameter: domain

    Vereist: Ja

    Type en beperkingen: Het vermelde domein, bijv. example.com, 3–253 tekens. Unicode (IDN) of ASCII; automatisch genormaliseerd naar punycode.

Retourneert

{
"listingId": "8f3c2a1e-4b5d-4e6f-9a7b-1c2d3e4f5a6b",
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"portfolioEligible": true,
"qualityOffer": "follow_account",
"leaseToOwn": {
"total": { "amount": "25000.00", "currency": "USD" },
"downPayment": { "amount": "5000.00", "currency": "USD" },
"finalPayment": null,
"installment": { "amount": "1666.66", "currency": "USD" },
"installments": 12
},
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z",
"forSalePageStatus": "live",
"cartLinks": {
"buyNow": "https://www.spaceship.com/domains/cart/?buyNow=brightharbor.com",
"leaseToOwn": "https://www.spaceship.com/domains/cart/?leaseToOwn=brightharbor.com"
},
"unavailable": []
}

  • Veld: listingId

    Betekenis: De ID (UUID) van de vermelding, de waarde die marketplace_listings_bulk_update gebruikt in listingIds.

  • Veld: domain / displayName

    Betekenis: Het domein in ASCII-vorm (punycode), en zoals het aan kopers wordt getoond.

  • Veld: status

    Betekenis: De status van de vermelding; zie de tabel onder marketplace_listings_list.

  • Veld: buyNow / minOffer

    Betekenis: { enabled, price }; price is { amount, currency } in Amerikaanse dollars, of null wanneer niet ingesteld.

  • Veld: description

    Betekenis: De tekst die aan kopers wordt getoond op de For Sale Page, of null.

  • Veld: forSalePage / contactOwner / showOnPortfolio

    Betekenis: Of de For Sale Page, het Contact Owner-formulier daarop en het domein op je portfoliopagina zijn ingeschakeld.

  • Veld: portfolioEligible

    Betekenis: Of de vermelding op je portfoliopagina kan verschijnen: deze is on_sale en heeft geen overeengekomen verkoop met een koper. De pagina toont niets zolang het portfolio niet zichtbaar is; anders toont deze met displayModeall elke in aanmerking komende vermelding, en met selected alleen de in aanmerking komende vermeldingen met showOnPortfolio ingeschakeld. Lees visibility en displayMode met marketplace_seller_settings_get.

  • Veld: qualityOffer

    Betekenis: follow_account (gebruikt je accountinstelling), disabled, optional, mandatory of mandatory_for_countries.

  • Veld: leaseToOwn

    Betekenis: De Lease-to-Own-voorwaarden (total, downPayment, finalPayment, installment, installments), of null wanneer Lease-to-Own is uitgeschakeld. downPayment en finalPayment zijn null wanneer die er niet zijn.

  • Veld: external / ownershipVerified

    Betekenis: Of de marketplace het domein behandelt als buiten Spaceship geregistreerd, en of het eigendom is geverifieerd. external is voorlopig zolang de status verifying is: elke nieuwe vermelding begint als true, en de eigendomscontrole zet dit op false voor een bij Spaceship geregistreerd domein.

  • Veld: addedAt

    Betekenis: Wanneer het domein werd vermeld, of null.

  • Veld: forSalePageStatus

    Betekenis: De huidige status van de For Sale Page: not_available, off, turning_off, needs_resolution, dns_records_missing, needs_dns_setup, connection_issue, connection_failed, connecting, live_ssl_pending of live; null wanneer onbekend.

  • Veld: cartLinks

    Betekenis: { buyNow, leaseToOwn } Add to Cart-links voor dit domein, of null wanneer ze niet konden worden gelezen. Een link is null wanneer kopers die niet kunnen gebruiken: de vermelding is niet on_sale, Nu kopen staat uit (buyNow), er zijn geen Lease-to-Own-voorwaarden (leaseToOwn), of het domein is toegezegd aan een koper via een overeengekomen verkoop of een bevestigde SafePay-deal (beide). De links komen terug zodra die deal eindigt zonder verkoop.

  • Veld: unavailable

    Betekenis: Onderdelen die niet op tijd konden worden gelezen: leeg, of ["cart_links"].

  • Veld: note

    Betekenis: Alleen aanwezig zolang de status verifying is: dat het eigendom wordt gecontroleerd, en wat moet worden gepubliceerd wanneer het domein buiten Spaceship is geregistreerd.

marketplace_listing_create — Een domein te koop aanbieden

Toegang: Gevoelig schrijven — zet het domein te koop tegen prijzen waar iedereen tegen kan kopen.

Zet een domein te koop op de Spaceship marketplace voor je account. Geef een Nu kopen-prijs, een minimum biedprijs of beide op; de beschrijving, pagina-instellingen (forSalePage, contactOwner, showOnPortfolio) en qualityOffer zijn optioneel en hebben dezelfde waarden als in marketplace_listing_update. Lease-to-Own-voorwaarden worden hier niet ingesteld: stel ze in met marketplace_listing_update zodra de vermelding bestaat. Een toch verzonden veld leaseToOwn wordt genegeerd. Een nieuwe vermelding begint met status verifying terwijl het eigendom wordt gecontroleerd en wordt pas aan kopers getoond zodra de controle slaagt: een bij Spaceship geregistreerd domein gaat meestal binnen ongeveer een minuut in de verkoop, en voor een elders geregistreerd domein verwijst de note naar de verificatierecords in marketplace_seller_settings_get. Terwijl de status verifying is, is external voorlopig en kan true zijn voor een Spaceship-domein. Dat is een normaal resultaat, geen fout.

Het domein wordt eerst vermeld met de prijzen en beschrijving; daarna worden de pagina-instellingen en Quality Offer in die volgorde opgeslagen. Als het vermelden van het domein zelf mislukt, geeft de aanroep een fout terug en is er niets vermeld. Als een latere groep mislukt, blijft het domein vermeld en noemt het antwoord die groep in notSaved (die is niet gewijzigd) of unconfirmed (of die is gewijzigd is onbekend); lees de vermelding met marketplace_listing_get en stel die groepen in met marketplace_listing_update in plaats van opnieuw te maken. Een domein dat je account al heeft vermeld wordt niet opnieuw vermeld en er wordt niets gewijzigd: het antwoord is de huidige vermelding met created: false, dus een herhaalde aanroep vermeldt een domein nooit twee keer.

  • Parameter: domain

    Vereist: Ja

    Type en beperkingen: Het te vermelden domein, bijv. example.com, 3–253 tekens. Unicode (IDN) of ASCII; automatisch genormaliseerd naar punycode.

  • Parameter: buyNowPrice

    Vereist: Voorwaardelijk

    Type en beperkingen: Nu kopen-prijs in Amerikaanse dollars als een tekenreeks, bijv. "2500" of "2500.00": groter dan 0, maximaal 10.000.000, tot 2 decimalen. Geef deze, minOfferPrice, of beide op.

  • Parameter: minOfferPrice

    Vereist: Voorwaardelijk

    Type en beperkingen: Laagste bod dat de vermelding accepteert, in Amerikaanse dollars; hetzelfde formaat als buyNowPrice. Geef deze, buyNowPrice, of beide op.

  • Parameter: description

    Vereist: Nee

    Type en beperkingen: Tekst die aan kopers wordt getoond op de For Sale Page, tot 400 tekens, zonder e-mailadressen. null laat dit leeg.

  • Parameter: forSalePage

    Vereist: Nee

    Type en beperkingen: Booleaans. Schakelt de For Sale Page van het domein in of uit.

  • Parameter: contactOwner

    Vereist: Nee

    Type en beperkingen: Booleaans. Schakelt het Contact Owner-formulier op de For Sale Page in of uit.

  • Parameter: showOnPortfolio

    Vereist: Nee

    Type en beperkingen: Booleaans. Toont of verbergt het domein op je portfoliopagina.

  • Parameter: qualityOffer

    Vereist: Nee

    Type en beperkingen: follow_account (gebruik je accountinstelling), disabled, optional of mandatory.

  • Parameter: qualityOfferDeposit

    Vereist: Voorwaardelijk

    Type en beperkingen: Geheel getal, hele Amerikaanse dollars, 10–50. Vereist bij qualityOfferoptional of mandatory, en anders niet toegestaan; zonder dit mislukt de aanroep met application.request.badRequest en wordt er niets verzonden.

Retourneert — een nieuwe vermelding:

{
"created": true,
"listing": {
"domain": "northpeak.io",
"displayName": "northpeak.io",
"status": "verifying",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": null,
"forSalePage": false,
"contactOwner": false,
"showOnPortfolio": false,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": true,
"ownershipVerified": false,
"addedAt": "2026-10-26T09:15:00.000Z"
},
"saved": ["prices"],
"notSaved": [],
"unconfirmed": [],
"note": "The ownership of this domain is being checked, and the listing is not shown to buyers until the check passes. While it is verifying, external is provisional: every new listing starts as external, also for a domain registered at Spaceship, so it does not tell where the domain is registered. A domain registered at Spaceship usually goes on sale within a minute or so; read the listing again with marketplace_listing_get. If the domain is registered elsewhere, add the DNS records listed under verification records by marketplace_seller_settings_get at the domain's DNS provider; the status changes from verifying once the check passes."
}

  • Veld: created

    Betekenis: true wanneer deze aanroep het domein heeft vermeld; false wanneer het al was vermeld (dan volgen alleen listing en note).

  • Veld: listing

    Betekenis: De vermelding zoals gelezen na de aanroep, met de velden van marketplace_listing_get tot en met addedAt. Weggelaten wanneer deze niet kon worden teruggelezen.

  • Veld: saved

    Betekenis: Groepen die zijn opgeslagen: prices (met de beschrijving, die samen met de prijzen wordt opgeslagen), page_settings, quality_offer.

  • Veld: notSaved

    Betekenis: Groepen die niet zijn gewijzigd.

  • Veld: unconfirmed

    Betekenis: Groepen waarvan de uitkomst onbekend is.

  • Veld: note

    Betekenis: Aanwezig wanneer het domein wacht op eigendomsverificatie, wanneer sommige groepen in notSaved of unconfirmed staan, of wanneer het domein al was vermeld.

marketplace_listing_update — Een Marketplace-vermelding bijwerken

Toegang: Gevoelige schrijfactie — een nieuwe prijs geldt meteen voor kopers.

Wijzigt een van de marketplace-vermeldingen van je account; alleen de velden die je opgeeft worden gewijzigd, en er moet er minstens één worden opgegeven. De velden vallen in groepen, die in deze volgorde worden opgeslagen: prijzen (buyNowPrice, minOfferPrice; null schakelt een van beide uit, en minstens één ervan moet ingeschakeld blijven: een wijziging waardoor geen van beide ingeschakeld blijft, wordt geweigerd voordat er iets wordt opgeslagen), daarna de beschrijving, pagina-instellingen (forSalePage, contactOwner, showOnPortfolio) en qualityOffer samen, daarna leaseToOwn (nieuwe voorwaarden, of { "enabled": false }). Prijzen zijn in Amerikaanse dollars.

Het antwoord vermeldt de groepen in saved, notSaved (niet gewijzigd: geweigerd, of niet bereikt omdat een eerdere groep werd geweigerd of omdat de aanroep geen tijd meer had) en unconfirmed (of deze is gewijzigd is onbekend), samen met de vermelding zoals die na de wijziging is gelezen. Een geweigerde groep die niet de eerste is, wordt op deze manier gemeld, niet als fout. Als de eerste groep mislukt, geeft de aanroep een fout terug en is er niets gewijzigd. Wanneer groepen in notSaved of unconfirmed staan, lees dan de vermelding met marketplace_listing_get voordat je ze opnieuw verstuurt, en herhaal geen groepen die zijn opgeslagen. Een domein dat je account niet heeft vermeld, geeft business.notFound terug.

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: Het vermelde domein, bijvoorbeeld example.com, 3–253 tekens. Unicode (IDN) of ASCII; automatisch genormaliseerd naar punycode.

  • Parameter: buyNowPrice

    Vereist: Nee

    Type & beperkingen: Nieuwe Buy Now-prijs in Amerikaanse dollars als een tekenreeks, bijvoorbeeld "2500" of "2500.00": groter dan 0, maximaal 10.000.000, tot 2 decimalen. null schakelt Buy Now uit.

  • Parameter: minOfferPrice

    Vereist: Nee

    Type & beperkingen: Nieuw laagste bod dat de vermelding accepteert, in Amerikaanse dollars; hetzelfde formaat. null stopt met het accepteren van biedingen.

  • Parameter: description

    Vereist: Nee

    Type & beperkingen: Tekst die aan kopers wordt getoond op de For Sale Page, tot 400 tekens, zonder e-mailadressen. null wist deze.

  • Parameter: forSalePage

    Vereist: Nee

    Type & beperkingen: Booleaans. Schakelt de For Sale Page van het domein in of uit.

  • Parameter: contactOwner

    Vereist: Nee

    Type & beperkingen: Booleaans. Schakelt het formulier Contact Owner op de For Sale Page in of uit.

  • Parameter: showOnPortfolio

    Vereist: Nee

    Type & beperkingen: Booleaans. Toont of verbergt het domein op je portfoliopagina.

  • Parameter: qualityOffer

    Vereist: Nee

    Type & beperkingen: follow_account (gebruik je accountinstelling), disabled, optional of mandatory.

  • Parameter: qualityOfferDeposit

    Vereist: Voorwaardelijk

    Type & beperkingen: Geheel getal, hele Amerikaanse dollars, 10–50. Vereist met qualityOfferoptional of mandatory, en anders niet toegestaan; zonder dit mislukt de aanroep met application.request.badRequest en wordt er niets verzonden.

  • Parameter: leaseToOwn.enabled

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer leaseToOwn is opgegeven. false schakelt Lease-to-Own uit; true stelt de onderstaande voorwaarden in.

  • Parameter: leaseToOwn.total

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer leaseToOwn.enabledtrue is. Totaalbedrag dat de koper gedurende de lease betaalt, in Amerikaanse dollars.

  • Parameter: leaseToOwn.downPayment

    Vereist: Nee

    Type & beperkingen: Betaling verschuldigd bij aanvang, in Amerikaanse dollars. Laat weg als er geen is.

  • Parameter: leaseToOwn.finalPayment

    Vereist: Nee

    Type & beperkingen: Betaling verschuldigd bij de laatste termijn, in Amerikaanse dollars. Laat weg als er geen is.

  • Parameter: leaseToOwn.installments

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer leaseToOwn.enabledtrue is. Aantal maandelijkse termijnen, 1–120; minstens 2 zonder aanbetaling. Het termijnbedrag is de rest van het totaal, na de aanbetaling en slotbetaling, gelijk verdeeld en naar beneden afgerond op de cent; die rest moet positief zijn en het afrondingsverschil minder dan 1 USD.

Retourneert — dezelfde vorm als marketplace_listing_create zonder created:

{
"listing": {
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "30000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "6000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z"
},
"saved": ["prices"],
"notSaved": ["page_settings", "lease_to_own"],
"unconfirmed": [],
"note": "Only the groups listed in saved were changed. The groups in notSaved were not changed; read the listing with marketplace_listing_get before sending them again."
}

Groepsnamen in saved, notSaved en unconfirmed zijn prices, description, page_settings, quality_offer en lease_to_own. listing wordt weggelaten wanneer deze niet kon worden teruggelezen; note is alleen aanwezig wanneer een groep in notSaved of unconfirmed staat, of wanneer het domein wacht op eigendomsverificatie.

marketplace_listing_delete — Een Marketplace-vermelding verwijderen

Toegang: Gevoelige schrijfactie — kan niet ongedaan worden gemaakt.

Haalt een van de domeinen van je account uit de verkoop op de Spaceship marketplace. De actieve onderhandelingen worden opgeschort en de SafePay-deals die je ervoor hebt geopend worden gedeactiveerd. Dit kan niet ongedaan worden gemaakt; het domein opnieuw vermelden start een nieuwe vermelding.

Bevestiging in twee stappen. De eerste aanroep wijzigt niets en geeft status: "confirmation_required" terug met wat er zal gebeuren (het domein, het aantal actieve onderhandelingen en het effect) en een confirmationToken; de antwoordtekst vermeldt hetzelfde, dus toon die aan de gebruiker. Zodra die akkoord gaat, roep je opnieuw aan met hetzelfde domein, de token en confirmationResponse: "accept" om de vermelding te verwijderen, of "decline" om te annuleren, wat status: "cancelled" teruggeeft en niets wijzigt. De token verloopt na korte tijd en is gekoppeld aan het domein, je account en het aantal actieve onderhandelingen dat werd getoond: een verlopen, gewijzigde of niet langer overeenkomende token geeft een nieuwe confirmation_required terug met een nieuwe token, nooit een fout en nooit een verwijdering. Een domein dat je account niet heeft vermeld, geeft business.notFound terug, precies zoals een domein dat door een ander account is vermeld. Als een bevestigde aanroep mislukt met infrastructure.serviceUnavailable, lees dan de vermelding met marketplace_listing_get voordat je opnieuw aanroept: een vermelding die is verwijderd, wordt niet gevonden.

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: Het vermelde domein dat uit de verkoop moet worden gehaald, bijvoorbeeld example.com, 3–253 tekens.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: Tekenreeks, 1–4096 tekens. Token die is teruggegeven door een eerdere aanroep van marketplace_listing_delete voor dit domein. Laat weg bij de eerste aanroep; stuur deze ongewijzigd opnieuw samen met confirmationResponse.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: "accept" of "decline". Alleen zinvol samen met een geldige confirmationToken. "accept" verwijdert de vermelding; "decline" annuleert. Laat weg bij de eerste aanroep.

Retourneert — na de eerste aanroep (niets gewijzigd):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ0IjoibWFya2V0cGxhY2UifQ.c2lnbmF0dXJl",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_listing_delete again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"domain": "brightharbor.com",
"activeNegotiations": 2,
"effect": "The domain is taken off sale. Its active negotiations are suspended and SafePay deals the seller opened for it are deactivated. This cannot be undone; listing the domain again starts a new listing."
}
}

Na de bevestigde aanroep:

{ "status": "removed", "domain": "brightharbor.com", "note": "The listing was removed from sale." }

  • status: confirmation_required

    Betekenis: Er is niets gewijzigd; bevestig met de geretourneerde confirmationToken.

  • status: cancelled

    Betekenis: Geweigerd; niets gewijzigd. Bevat ook domain en note.

  • status: removed

    Betekenis: De vermelding is uit de verkoop gehaald.

marketplace_listing_verify — Controleer het domeineigendom van een vermelding

Toegang: Schrijven.

Start nu een eigendomscontrole voor een van de vermeldingen van je account die wacht op verificatie (status verifying). Het antwoord komt binnen de aanroep en zegt of er een controle is gestart, met de huidige status van de vermelding; de controle zelf wordt op de achtergrond uitgevoerd, dus lees de vermelding later met marketplace_listing_get — de status verlaat verifying zodra de controle slaagt. De DNS-records die je moet publiceren bij de DNS-provider van het domein staan onder verificatierecords in marketplace_seller_settings_get.

Een vermelding die niet wacht op verificatie is een normaal resultaat: deze wordt beantwoord met zijn status en checkStarted: false, en er wordt geen controle gestart. Een domein dat je account niet heeft vermeld, geeft business.notFound terug. De aanroep kan op elk moment worden herhaald.

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: Het vermelde domein waarvan het eigendom nu moet worden gecontroleerd, bijvoorbeeld example.com, 3–253 tekens.

Retourneert

{
"domain": "northpeak.io",
"status": "verifying",
"checkStarted": true,
"note": "An ownership check of this domain was started. It runs in the background; read the listing with marketplace_listing_get later: the status leaves \"verifying\" once the check passes. If it does not, make sure the DNS records listed under verification records by marketplace_seller_settings_get are published at the domain's DNS provider."
}

checkStarted is false zowel wanneer de vermelding niet wacht op verificatie (dan is status niet verifying) als wanneer de vermelding wel wacht op verificatie maar er nu geen controle kon worden gestart; note zegt welke van de twee, en probeer in het tweede geval later opnieuw.

marketplace_listings_bulk_verify — Controleer eigendom van alle niet-geverifieerde vermeldingen

Toegang: Schrijven.

Start nu een eigendomscontrole voor elke vermelding van je account die wacht op verificatie (status verifying). Het antwoord komt binnen de aanroep met listingsChecked, het aantal vermeldingen waarvoor een controle is gestart; de controles worden op de achtergrond uitgevoerd, dus lees de vermeldingen later met marketplace_listings_list gefilterd op status verifying om te zien welke zijn geslaagd. Wanneer geen enkele vermelding wacht op verificatie, is listingsChecked0 en wordt er niets gestart; dat is geen fout. De te publiceren DNS-records staan onder verificatierecords in marketplace_seller_settings_get. De aanroep kan op elk moment worden herhaald.

Geen parameters.

Retourneert

{
"listingsChecked": 3,
"note": "Ownership checks were started for the listings waiting for verification. They run in the background; read the listings with marketplace_listings_list (status \"verifying\") later to see which passed."
}

Accountbrede verkopersinstellingen, portfoliostatistieken, verkochte domeinen en de "buy now"-checkoutlinks die je met kopers deelt.

marketplace_seller_settings_get — Verkopersinstellingen ophalen

Toegang: Lezen.

Leest de verkopersinstellingen van je account in één antwoord: de openbare portfoliopagina, de accountbrede Quality Offer-instelling, je uitbetalingsmethoden en de DNS-records die eigendom bewijzen van een elders geregistreerd domein. portfolio en qualityOffer zijn null wanneer ze nooit zijn ingesteld; dat is een normaal resultaat, geen fout.

De vier onderdelen worden naast elkaar gelezen binnen één tijdslimiet. Een onderdeel dat niet op tijd kon worden gelezen is null en wordt genoemd in unavailable (portfolio, quality_offer, payout_methods of verification), en de onderdelen die wel zijn gelezen worden nog steeds geretourneerd; unavailable wordt weggelaten wanneer elk onderdeel is gelezen. Wanneer geen enkel onderdeel op tijd kon worden gelezen, mislukt de aanroep met infrastructure.serviceUnavailable ("The marketplace did not answer in time.").

Uitbetalingsmethoden zijn gemaskeerd. Elke methode toont alleen de methode, een gedeeltelijk verborgen account en of deze de standaard en actief is: een PayPal-adres behoudt het eerste teken en het domein (s***@example.com), een Bitcoin-adres of bankrekening (IBAN of rekeningnummer) behoudt alleen de laatste vier tekens (****6789). Er worden nooit andere uitbetalingsgegevens geretourneerd. Uitbetalingsmethoden zijn hier alleen-lezen; ze worden gewijzigd in je Spaceship-account.

Geen parameters.

Retourneert

{
"portfolio": {
"visibility": true,
"nickname": "Greatest Domains",
"description": "Premium names",
"slug": "greatest-domains",
"displayMode": "all",
"url": "https://www.spaceship.com/domains/portfolio/greatest-domains"
},
"qualityOffer": {
"requirement": "mandatory_for_countries",
"depositAmount": 25,
"countries": ["US", "CA"],
"otherCountriesMode": "keep_disabled"
},
"payoutMethods": [
{ "method": "paypal", "account": "s***@example.com", "isDefault": true, "isActive": true },
{ "method": "wire_transfer", "account": "****6789", "isDefault": false, "isActive": true }
],
"verification": {
"options": [
{ "records": [{ "type": "TXT", "name": "@", "value": "spaceship-verification=abc123" }] }
]
}
}

  • Veld: portfolio

    Betekenis: De portfoliopagina, of null. description wordt weggelaten wanneer deze leeg is. displayMode is all (elk vermeld domein) of selected (alleen de voor de pagina gekozen domeinen). url is de openbare paginalink.

  • Veld: qualityOffer

    Betekenis: De accountbrede Quality Offer-instelling, of null. requirement is disabled, optional, mandatory of mandatory_for_countries. depositAmount is in hele Amerikaanse dollars en wordt weggelaten wanneer de vereiste disabled is. countries en otherCountriesMode (keep_disabled of make_optional) zijn van toepassing op mandatory_for_countries.

  • Veld: payoutMethods

    Betekenis: Gemaskeerde uitbetalingsmethoden: method (paypal, bitcoin of wire_transfer), account (gemaskeerd; weggelaten wanneer het niet gemaskeerd kan worden getoond), isDefault, isActive. null wanneer ze niet op tijd konden worden gelezen.

  • Veld: verification.options

    Betekenis: Alternatieve sets DNS-records; het toevoegen van de records van één optie bij de DNS-host van het domein bewijst eigendom van een elders geregistreerd domein. verification is null wanneer deze niet op tijd kon worden gelezen.

  • Veld: unavailable

    Betekenis: Alleen wanneer een onderdeel niet op tijd kon worden gelezen: de onderdelen die om die reden null zijn.

marketplace_seller_settings_update — Verkopersinstellingen bijwerken

Toegang: Gevoelige schrijfactie — vervangt de accountbrede Quality Offer-instelling in haar geheel.

Wijzigt de openbare portfoliopagina, de accountbrede Quality Offer-instelling, of beide. Verstuur ten minste één van portfolio en qualityOffer. Voor de portfoliopagina worden alleen de velden die je verstuurt gewijzigd; de eerste keer dat de pagina wordt ingesteld, zijn visibility, nickname en slug allemaal vereist, anders mislukt de aanroep met business.invalidArgument en wordt er niets opgeslagen. De slug wordt alleen dan ingesteld: de slug (het adres) van een bestaande pagina kan niet worden gewijzigd, en een andere slug mislukt met business.invalidArgument ("The slug (address) of an existing portfolio page cannot be changed.") en er wordt niets opgeslagen, omdat de links van de pagina al zijn gedeeld. De slug van een nieuwe pagina wordt op beschikbaarheid gecontroleerd voordat er iets wordt opgeslagen; een bezette, gereserveerde of ongeldige slug mislukt met business.invalidArgument en er wordt niets opgeslagen. De Quality Offer-instelling wordt in haar geheel vervangen, inclusief de landenlijst, en is van toepassing op vermeldingen die geen eigen instelling hebben. Uitbetalingsmethoden kunnen hier niet worden gewijzigd.

Een wijziging alleen voor het portfolio wordt meteen opgeslagen. Een aanroep met qualityOffer heeft twee stappen. De eerste aanroep leest de huidige instelling, wijzigt niets en geeft status: "confirmation_required" terug met een confirmationToken en een confirmation met de huidige instelling (current, null wanneer er geen actief is), de resulterende instelling (resulting) en een summary van beide, waarin elk land wordt genoemd waarop de aanbetaling voor en na van toepassing is en de landen die wegvallen. Een tweede aanroep met hetzelfde portfolio en qualityOffer, die token en confirmationResponse: "accept" slaat op; "decline" slaat niets op en geeft status: "cancelled" terug. De token is gekoppeld aan de argumenten en aan de opgeslagen instelling: als de instelling tussendoor is gewijzigd, geeft de tweede aanroep een nieuwe confirmation_required terug in plaats van op te slaan.

Wanneer beide groepen worden verzonden, wordt eerst de portfoliopagina opgeslagen. Het antwoord vermeldt elke groep als saved, notSaved of unconfirmed: als de Quality Offer-instelling daarna wordt geweigerd, slaagt de aanroep nog steeds met portfolio in saved, quality_offer in notSaved en een note; als de uitkomst onbekend is, staat quality_offer in unconfirmed en vraagt de note je om de instellingen te lezen voordat je het opnieuw probeert. Als de aanroep mislukt met infrastructure.serviceUnavailable, kan de wijziging toch zijn opgeslagen: lees deze met marketplace_seller_settings_get voordat je opnieuw opslaat.

Voordat er iets wordt opgeslagen, worden de huidige instellingen gelezen binnen één tijdslimiet. Wanneer ze niet op tijd kunnen worden gelezen, wordt er niets opgeslagen: de aanroep slaagt met saved leeg, elke groep die je hebt verzonden in notSaved en een note.

  • Parameter: portfolio

    Vereist: Voorwaardelijk

    Type & beperkingen: Object; vereist wanneer qualityOffer wordt weggelaten. Moet ten minste één veld wijzigen.

  • Parameter: portfolio.visibility

    Vereist: Voorwaardelijk

    Type & beperkingen: Booleaans: of de portfoliopagina openbaar is. Vereist de eerste keer dat de pagina wordt ingesteld.

  • Parameter: portfolio.nickname

    Vereist: Voorwaardelijk

    Type & beperkingen: Tekenreeks, 1–50 tekens: weergavenaam op de pagina. Vereist de eerste keer dat de pagina wordt ingesteld.

  • Parameter: portfolio.description

    Vereist: Nee

    Type & beperkingen: Tekenreeks, tot 400 tekens, weergegeven op de pagina. Een lege tekenreeks wist deze.

  • Parameter: portfolio.slug

    Vereist: Voorwaardelijk

    Type & beperkingen: Tekenreeks, 3–50 tekens: letters, cijfers en enkele koppeltekens, geen koppelteken aan het begin of einde. Beschikbaarheid wordt gecontroleerd voordat er wordt opgeslagen. Vereist wanneer de pagina voor het eerst wordt ingesteld; de slug van een bestaande pagina kan niet worden gewijzigd.

  • Parameter: portfolio.displayMode

    Vereist: Nee

    Type & beperkingen: all (elk vermeld domein) of selected (alleen de domeinen die voor de pagina zijn gekozen).

  • Parameter: qualityOffer

    Vereist: Voorwaardelijk

    Type & beperkingen: Object; vereist wanneer portfolio is weggelaten. Vervangt de volledige accountbrede instelling.

  • Parameter: qualityOffer.requirement

    Vereist: Ja (in qualityOffer)

    Type & beperkingen: disabled, optional, mandatory of mandatory_for_countries (een aanbetaling alleen uit de vermelde landen).

  • Parameter: qualityOffer.depositAmount

    Vereist: Voorwaardelijk

    Type & beperkingen: Geheel getal, 10–50, hele Amerikaanse dollars. Vereist tenzij requirementdisabled is, en niet toegestaan met disabled.

  • Parameter: qualityOffer.countries

    Vereist: Voorwaardelijk

    Type & beperkingen: 1–250 ISO 3166-1 alpha-2-landcodes van twee letters, zonder herhalingen. Vereist met mandatory_for_countries en alleen daarmee toegestaan.

  • Parameter: qualityOffer.otherCountriesMode

    Vereist: Voorwaardelijk

    Type & beperkingen: keep_disabled (geen aanbetaling voor andere landen) of make_optional. Vereist met mandatory_for_countries en alleen daarmee toegestaan.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: Tekenreeks, maximaal 4096 tekens. De token van een eerdere aanroep met qualityOffer en dezelfde argumenten. Weglaten bij de eerste aanroep. Verloopt na korte tijd.

  • Parameter: confirmationResponse

    Vereist: Nee

    Type & beperkingen: accept of decline; alleen zinvol met een geldige confirmationToken.

Retourneert — bij de eerste aanroep met qualityOffer, de bevestiging:

{
"status": "confirmation_required",
"confirmationToken": "<opaque token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_seller_settings_update again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Replace the account-wide Quality Offer setting? Now: buyers in US, CA pay a $25 Quality Offer deposit with an offer, and buyers from every other country pay no deposit. After saving: buyers in UA pay a $25 Quality Offer deposit with an offer, and buyers from every other country pay no deposit. Buyers in US, CA will no longer be asked for the deposit. The setting applies to listings that do not have their own Quality Offer setting.",
"current": { "requirement": "mandatory_for_countries", "depositAmount": 25, "countries": ["US", "CA"], "otherCountriesMode": "keep_disabled" },
"resulting": { "requirement": "mandatory_for_countries", "depositAmount": 25, "countries": ["UA"], "otherCountriesMode": "keep_disabled" }
}
}

Na het opslaan (of bij een wijziging alleen voor de portfolio), de groepen per uitkomst, plus de opgeslagen waarden van elke opgeslagen groep:

{
"saved": ["portfolio", "quality_offer"],
"notSaved": [],
"unconfirmed": [],
"portfolio": {
"visibility": true,
"nickname": "Greatest Domains",
"description": "Premium names",
"slug": "greatest-domains",
"displayMode": "all",
"url": "https://www.spaceship.com/domains/portfolio/greatest-domains"
},
"qualityOffer": { "requirement": "mandatory", "depositAmount": 50 }
}

Wanneer de portfoliopagina was opgeslagen maar de Quality Offer-instelling was afgewezen:

{
"saved": ["portfolio"],
"notSaved": ["quality_offer"],
"unconfirmed": [],
"portfolio": { "visibility": false, "nickname": "Greatest Domains", "slug": "greatest-domains", "displayMode": "all", "url": "https://www.spaceship.com/domains/portfolio/greatest-domains" },
"note": "The portfolio page was saved. The Quality Offer setting was rejected and is unchanged."
}

Wanneer de huidige instellingen niet op tijd konden worden gelezen:

{
"saved": [],
"notSaved": ["portfolio", "quality_offer"],
"unconfirmed": [],
"note": "The current seller settings could not be read in time, so nothing was saved."
}

marketplace_insights_get — Seller Insights ophalen

Toegang: Lezen.

Toont hoe je verkopersportfolio presteert, in één antwoord: portfoliostatus, onderhandelingen en SafePay-deals per status, verkopen per bron en land, verkeer, omzet en uitbetaling (altijd en de afgelopen 30 dagen), plus je topdomeinen gerangschikt op views, visits of searches onder de vermeldingen die het SellerHub Dashboard meetelt in verkeer: te koop, verificatie bezig, verkoopverwerking en wachtend op overdracht (gestopte verkoop, privéverkoop, geleasede, verkochte en mislukte vermeldingen worden weggelaten). De cijfers worden berekend door de Spaceship marketplace en kunnen iets achterlopen op live activiteit. Een portfolio zonder activiteit geeft nulwaarden en een lege lijst met topdomeinen terug. De topdomeinen worden naast de andere cijfers gelezen binnen een korte tijdslimiet; wanneer ze niet op tijd kunnen worden gelezen, is topDomainsnull, is unavailable["top_domains"] en worden de andere cijfers nog steeds geretourneerd.

  • Parameter: topBy

    Vereist: Nee

    Type & beperkingen: views (paginaweergaven), visits of searches, altijd, hoogste eerst. Standaard visits.

  • Parameter: topCount

    Vereist: Nee

    Type & beperkingen: Geheel getal, 1–50: hoeveel topdomeinen moeten worden geretourneerd. Standaard 10.

Retourneert

{
"portfolio": {
"total": 40, "listed": 30, "onLease": 2, "pendingVerification": 1,
"withoutPrices": 4, "expiringSoon": 3, "notListed": 10, "asOf": "2026-10-26T06:00:00.000Z"
},
"negotiations": { "total": 12, "inNegotiation": 7, "agreedOrInTransfer": 2, "contactRequests": 2, "cancelledOrPaused": 1 },
"safePay": { "awaitingPayment": 1, "pendingConfirmation": 0 },
"sales": {
"total": 3,
"bySource": [{ "key": "forSalePage", "count": 2 }],
"byCountry": [{ "key": "US", "count": 3 }]
},
"traffic": { "totalViews": "5400", "totalSearches": "320", "viewsBySource": [{ "key": "search", "count": "4100" }] },
"financials": {
"revenue": { "allTime": { "amount": "15000.00", "currency": "USD" }, "last30Days": { "amount": "2500.00", "currency": "USD" } },
"payout": { "allTime": { "amount": "14250.00", "currency": "USD" }, "last30Days": { "amount": "2375.00", "currency": "USD" } },
"sold": { "allTime": 3, "last30Days": 1 }
},
"topDomains": {
"sortedBy": "views",
"total": 1,
"items": [{
"domain": "greatdomain.com", "external": false,
"views": "900", "visits": "300", "searches": "30",
"viewsToday": "12", "visitsToday": "4", "searchesToday": "1"
}]
}
}

  • Veld: portfolio

    Betekenis: Aantallen domeinen per status. asOf is wanneer de aantallen voor het laatst zijn berekend, of null.

  • Veld: negotiations

    Betekenis: Biedingen en onderhandelingen per status: inNegotiation; agreedOrInTransfer, elke onderhandeling na de overeenkomst (overeenkomst bereikt, betaald of het domein wordt overgedragen), dus dit is niet het aantal onderhandelingen met de status agreement_reached; contactRequests; cancelledOrPaused.

  • Veld: safePay

    Betekenis: SafePay-deals die wachten op betaling of op bevestiging.

  • Veld: sales

    Betekenis: Aantal verkopen, per bron en per land, elk als { key, count }.

  • Veld: traffic

    Betekenis: Altijd geldende views en searches, en views per bron. Grote tellers worden als tekenreeksen geretourneerd.

  • Veld: financials

    Betekenis: Omzet en uitbetaling als { amount, currency } voor altijd en de afgelopen 30 dagen, en het aantal verkochte domeinen.

  • Veld: topDomains

    Betekenis: De gebruikte rangschikking (sortedBy), het aantal domeinen dat het omvat (total) en maximaal topCount domeinen met altijd geldende en huidige views, visits en searches. external is true voor een domein dat elders is geregistreerd. null wanneer de topdomeinen niet op tijd konden worden gelezen.

  • Veld: unavailable

    Betekenis: Alleen wanneer de topdomeinen niet op tijd konden worden gelezen: ["top_domains"].

marketplace_sales_list — Verkochte domeinen weergeven

Toegang: Lezen.

Geeft een lijst van de domeinen die je hebt verkocht: het domein, wanneer het is verkocht, de verkoopprijs, je uitbetaling na de marketplace-kosten en het kanaal waarlangs de verkoop plaatsvond. Je kunt de lijst beperken tot een verkoopperiode. Een periode zonder verkopen geeft een lege lijst terug, geen fout; een periode waarvan het einde niet later is dan het begin mislukt met application.request.badRequest.

De lijst is gepagineerd met een cursor: geef de nextCursor van een pagina door als cursor om de volgende op te halen. Een pagina zonder nextCursor is de laatste.

  • Parameter: soldFrom

    Vereist: Nee

    Type & beperkingen: ISO 8601-datum-tijd met een tijdzone, bijvoorbeeld soldFrom: "2026-01-01T00:00:00Z". Alleen verkopen op of na dit moment.

  • Parameter: soldTo

    Vereist: Nee

    Type & beperkingen: ISO 8601-datum-tijd met een tijdzone. Alleen verkopen vóór dit moment (exclusief). Moet later zijn dan soldFrom.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Geheel getal, 1–100: verkopen per pagina. Standaard 50.

  • Parameter: cursor

    Vereist: Nee

    Type & beperkingen: Tekenreeks, 1–2048 tekens: de nextCursor van de vorige pagina. Weglaten voor de eerste pagina.

Retourneert

{
"items": [
{
"domain": "greatdomain.com",
"soldAt": "2026-09-30T12:00:00.000Z",
"price": { "amount": "2500.00", "currency": "USD" },
"payout": { "amount": "2375.00", "currency": "USD" },
"channel": "forSalePage"
}
],
"nextCursor": "eyJwYWdlIjoyfQ"
}

soldAt kan null zijn wanneer het verkooptijdstip niet is vastgelegd. Zonder verkopen in de periode is het antwoord { "items": [] }.

Toegang: Lezen.

Geeft een lijst van je checkoutlinks: het domein, het soort link, de status, de link-URL, de prijs, wat de koper betaalt en wat jij ontvangt, de kostenverdeling en wanneer de link niet meer werkt. Je kunt filteren op domein; het filter komt overeen met een deel van de naam. Een filter dat niets oplevert geeft een lege lijst terug met total 0, geen fout.

De lijst is gepagineerd met take en skip; total is het aantal links dat overeenkomt met het filter.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: Tekenreeks, 1–255 tekens. Alleen links waarvan de domeinnaam deze tekst bevat.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Geheel getal, 1–100: links per pagina. Standaard 50.

  • Parameter: skip

    Vereist: Nee

    Type & beperkingen: Geheel getal, 0 of meer: links die vóór de pagina moeten worden overgeslagen. Standaard 0.

Retourneert

{
"items": [
{
"domain": "greatdomain.com",
"type": "buy_now",
"status": "active",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78",
"price": { "amount": "2500.00", "currency": "USD" },
"buyerPays": { "amount": "2500.00", "currency": "USD" },
"sellerReceives": { "amount": "2375.00", "currency": "USD" },
"sellerFeeShare": 100,
"buyerFeeShare": 0,
"validTill": "2026-11-01T00:00:00.000Z",
"createdAt": "2026-10-25T10:00:00.000Z"
}
],
"total": 1
}

  • Veld: type

    Betekenis: buy_now, lease_to_own of make_offer; unknown voor een soort die hier niet wordt vermeld.

  • Veld: status

    Betekenis: active, expired, deactivated of purchased; unknown voor een status die hier niet wordt vermeld. Alleen een active link kan worden gebruikt om te kopen.

  • Veld: price / leaseToOwnTotal

    Betekenis: De prijs van de link, en bij een lease-to-own-link het totaal dat moet worden betaald. Elk wordt weggelaten wanneer het niet is ingesteld.

  • Veld: buyerPays / sellerReceives

    Betekenis: Wat de koper betaalt en wat jij ontvangt na de marketplace-kosten. Weggelaten wanneer niet beschikbaar.

  • Veld: sellerFeeShare / buyerFeeShare

    Betekenis: Percentage van de marketplace-kosten dat door jou en door de koper wordt betaald.

  • Veld: validTill / createdAt

    Betekenis: Wanneer de link niet meer werkt en wanneer deze is gemaakt.

Toegang: Gevoelig schrijven — iedereen die de link heeft, kan het domein 7 dagen lang kopen.

Maakt een deelbare checkoutlink met "nu kopen" voor een van je domeinen die te koop staat. De link is 7 dagen geldig en is niet gekoppeld aan een koper: iedereen die de link heeft, kan het domein kopen voor de prijs ervan. Daarom maakt de assistent pas een link nadat je akkoord bent gegaan met de prijs en de kostenverdeling: wanneer je om een link vraagt zonder beide te noemen, leest deze eerst de vermelding en vertelt hij je welke voorwaarden de link zou hebben. Zonder price wordt de eigen nu-kopen-prijs van de vermelding gebruikt; zonder sellerFeeShare betaal jij de volledige marketplace-kosten. Een domein dat niet een van je vermeldingen is, mislukt met business.notFound. De prijs moet minimaal 100 USD zijn; een lagere prijs mislukt met business.invalidArgument ("The minimum checkout link price is 100 USD.") en er wordt niets gemaakt. Een link wordt geweigerd met business.conflict en een zin die de reden noemt wanneer je vermelding nog niet te koop staat (bijvoorbeeld omdat het eigendom nog wordt geverifieerd), of wanneer het domein een overeengekomen deal met een koper heeft, in onderhandeling is of via een bevestigde SafePay-deal loopt.

Elke aanroep maakt een nieuwe link en laat eerdere links actief, dus het herhalen van een aanroep geeft je een tweede link. Als de aanroep mislukt met infrastructure.serviceUnavailable, kan de link toch zijn gemaakt: zoek ernaar met marketplace_checkout_links_list voordat je er nog een maakt.

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: Tekenreeks, 4–255 tekens, Unicode of ASCII. Een van je vermeldingen die te koop staat.

  • Parameter: price.amount

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer price wordt verzonden. Positief decimaal bedrag met maximaal twee decimalen, bijvoorbeeld "2500.00".

  • Parameter: price.currency

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist wanneer price wordt verzonden. Valutacode van drie letters; alleen USD wordt ondersteund.

  • Parameter: sellerFeeShare

    Vereist: Nee

    Type & beperkingen: 0, 25, 50, 75 of 100: percentage van de marketplace-kosten dat jij betaalt; de koper betaalt de rest. Standaard: jij betaalt alles.

Retourneert — het domein (in ASCII-vorm), de link en wanneer deze niet meer werkt:

{
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/zz99yy88xx77ww66",
"validTill": "2026-11-02T00:00:00.000Z"
}

Toegang: Gevoelig schrijven — deactiveert de link definitief.

Deactiveert een van je actieve checkoutlinks, gevonden op basis van de URL. Daarna kan niemand er nog via kopen, en dit kan niet ongedaan worden gemaakt: om opnieuw via een link te verkopen, maak je een nieuwe. De tool bevestigt zichzelf. De eerste aanroep verandert niets en geeft confirmation_required terug met wat er gaat gebeuren en een kortlevende confirmationToken; toon dit aan de gebruiker en roep, zodra die akkoord gaat, opnieuw aan met dezelfde argumenten, de token en confirmationResponseaccept. decline geeft cancelled terug en verandert niets. Een token die is verlopen, voor andere argumenten is uitgegeven of niet langer overeenkomt met de link (bijvoorbeeld omdat de vervaldatum is gewijzigd) krijgt een nieuwe confirmation_required in plaats van een deactivering.

Een link die niet tot je checkoutlinks behoort geeft business.notFound terug, precies zoals een link die niet bestaat. Een link die niet langer actief is (verlopen, gedeactiveerd of gekocht) mislukt met business.conflict. Een URL die geen checkoutlink-URL is mislukt met business.invalidArgument. In een zeer lange lijst kan de link mogelijk niet op tijd worden gevonden; de aanroep geeft dan statuslookup_incomplete terug met deactivated: false en een note, en er wordt niets gewijzigd. Het doorgeven van de domain van de link beperkt de zoekopdracht tot de links van dat domein. Als de aanroep mislukt met infrastructure.serviceUnavailable na accept, kan de link al gedeactiveerd zijn: controleer dit met marketplace_checkout_links_list voordat je het opnieuw probeert.

  • Parameter: checkoutUrl

    Vereist: Ja

    Type & beperkingen: Tekenreeks, 1–2048 tekens: de checkoutlink-URL, zoals vermeld door marketplace_checkout_links_list.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: Tekenreeks, 1–255 tekens: het domein van de link, om de link sneller te vinden in een lange lijst.

  • Parameter: confirmationToken

    Vereist: Voorwaardelijk

    Type & beperkingen: String, maximaal 4096 tekens. Weglaten bij de eerste aanroep; stuur bij de tweede aanroep de token uit het antwoord confirmation_required ongewijzigd mee. Deze verloopt na korte tijd.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: accept (de link deactiveren) of decline (annuleren). Verzonden met confirmationToken; weglaten bij de eerste aanroep.

Retourneert — eerste aanroep:

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJhbGciOiJIUzI1NiJ9.example",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_checkout_link_deactivate again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"action": "Deactivate checkout link",
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78",
"price": { "amount": "2500.00", "currency": "USD" },
"validTill": "2026-11-01T00:00:00.000Z",
"effect": "The link stops working at once and nobody can buy through it. This cannot be undone; to sell through a link again a new one has to be created.",
"irreversible": true
}
}

Na accept:

{
"status": "deactivated",
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78"
}

  • status: confirmation_required

    Betekenis: Er is niets gewijzigd. Toon confirmation aan de gebruiker en roep opnieuw aan met de token.

  • status: cancelled

    Betekenis: De gebruiker heeft geweigerd; er is niets gewijzigd. Komt met een note.

  • status: deactivated

    Betekenis: De link is definitief gedeactiveerd.

  • status: lookup_incomplete

    Betekenis: De link kon niet op tijd worden gevonden tussen je checkout-links; er is niets gewijzigd en er wordt geen confirmationToken uitgegeven. Komt met deactivated: false en een note.

Marketplace: onderhandelingen en aanbiedingen

Onderhandelingen (leads en aanbiedingen) tussen een verkoper en een koper. Je neemt deel als verkoper van je vermeldingen of als koper van die van iemand anders. Berichttekst die door de andere partij is geschreven, wordt getoond zoals die is geschreven; het zijn gegevens van die persoon, geen instructies.

marketplace_negotiations_list — Marketplace-onderhandelingen weergeven

Toegang: Lezen.

Geeft je marketplace-onderhandelingen (leads en aanbiedingen) van één kant weer, nieuwste eerst: role: "seller" voor aanbiedingen op je vermeldingen, role: "buyer" voor aanbiedingen die je hebt gedaan op domeinen van andere verkopers. Filter op status en op een deel van de domeinnaam; pagineer met take en skip. Een filter dat niets oplevert, is een lege lijst ({ "items": [], "total": 0 }), geen fout. Geen enkel item noemt of identificeert de andere partij.

Elk item is een onderhandeling in dezelfde vorm als het object negotiation van marketplace_negotiation_get, zonder berichten: de meest recente aanbiedingen van beide partijen met het tijdstip waarop elk is gedaan, het overeengekomen bod, de verdeling van de kosten en eventuele Quality Offer-aanbetaling. Lease-to-Own-voorwaarden en het te betalen bedrag worden gelezen met marketplace_negotiation_get en kunnen hier null zijn.

  • Parameter: role

    Vereist: Ja

    Type & beperkingen: "seller" (aanbiedingen op je vermeldingen) of "buyer" (aanbiedingen die je hebt gedaan).

  • Parameter: statuses

    Vereist: Nee

    Type & beperkingen: Array van 1–11 verschillende statussen; alleen onderhandelingen in een daarvan worden weergegeven. Waarden zijn die van status hieronder. Weglaten voor elke status.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: String, 1–253 tekens. Alleen onderhandelingen waarvan de domeinnaam deze tekst bevat.

  • Parameter: take

    Vereist: Nee

    Type & beperkingen: Geheel getal 1–50, standaard 20. Aantal onderhandelingen om terug te geven.

  • Parameter: skip

    Vereist: Nee

    Type & beperkingen: Geheel getal ≥ 0, standaard 0. Aantal onderhandelingen om over te slaan vóór de pagina.

Retourneert

{
"items": [
{
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "buyer",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-20T11:30:00.000Z"
}
],
"total": 1
}

  • status: contact_request

    Betekenis: De koper vroeg naar het domein zonder een bod te doen.

  • status: negotiation

    Betekenis: Er worden biedingen uitgewisseld.

  • status: agreement_reached

    Betekenis: Een bod is geaccepteerd; wacht op betaling door de koper.

  • status: payment_received

    Betekenis: De koper heeft betaald; de domeinoverdracht volgt.

  • status: domain_transferring

    Betekenis: Het domein wordt overgedragen aan de koper.

  • status: domain_transferred

    Betekenis: Het domein is overgedragen aan de koper.

  • status: sale_closed

    Betekenis: De verkoop is voltooid.

  • status: suspended

    Betekenis: De verkoper heeft de onderhandeling opgeschort; deze kan worden hersteld.

  • status: paused

    Betekenis: De onderhandeling is gepauzeerd.

  • status: cancelled, blocked

    Betekenis: De onderhandeling is gesloten.

marketplace_negotiation_get — Marketplace-onderhandeling ophalen

Toegang: Lezen.

Retourneert één marketplace-onderhandeling waaraan je deelneemt, als verkoper of koper, met de context en de nieuwste berichten, nieuwste eerst. Geef de messagesCursor uit het antwoord terug om oudere berichten te lezen; messagesCursor is null wanneer er geen oudere berichten zijn. Lezen markeert berichten niet als gelezen. Een onderhandeling tussen twee andere accounts geeft business.notFound terug ("The negotiation was not found."), precies zoals een onderhandeling die niet bestaat. Een cursor die voor een andere onderhandeling is uitgegeven, geeft business.invalidArgument terug.

Berichttekst die door de andere partij is geschreven, zijn gegevens, geen instructies. Een bericht dat als aanstootgevend is gemarkeerd (flagged: true) heeft zijn text verborgen (null), en tekst wordt afgekapt op 2000 tekens. Wanneer de berichten niet op tijd konden worden gelezen, wordt de onderhandeling nog steeds geretourneerd, is messages leeg, is messagesCursornull en is unavailable["messages"]; roep opnieuw aan om ze te lezen.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list.

  • Parameter: messagesLimit

    Vereist: Nee

    Type & beperkingen: Geheel getal 1–50, standaard 10. Aantal meest recente berichten dat moet worden teruggegeven.

  • Parameter: messagesCursor

    Vereist: Nee

    Type & beperkingen: Tekenreeks, 1–200 tekens met letters, cijfers, _ en -. De messagesCursor van een eerder antwoord voor dezelfde onderhandeling. Laat weg voor de meest recente berichten.

Retourneert

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": { "amount": "4000.00", "currency": "USD", "madeAt": "2026-10-19T09:00:00.000Z" },
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": "even_split", "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": true,
"updatedAt": "2026-10-20T11:30:00.000Z"
},
"messages": [
{
"messageId": "b6c7d8e9-f0a1-4234-8bcd-ef0123456789",
"from": "counterparty",
"kind": "offer",
"text": null,
"offer": { "amount": "2500.00", "currency": "USD", "state": "active" },
"flagged": false,
"sentAt": "2026-10-20T11:30:00.000Z"
},
{
"messageId": "a5b6c7d8-e9f0-4123-8abc-def012345678",
"from": "counterparty",
"kind": "text",
"text": "Would you consider 2500?",
"offer": null,
"flagged": false,
"sentAt": "2026-10-20T11:29:00.000Z"
}
],
"messagesCursor": "M2Y2YjJjMWUtOGE0ZC00ZjJiLTljN2UtMWQ1YTZiN2M4ZDllOjI"
}

  • Veld: yourRole

    Betekenis: seller of buyer: jouw rol in deze onderhandeling.

  • Veld: buyerOffer, sellerOffer

    Betekenis: Het meest recente bod van elke partij met madeAt, het tijdstip waarop het is gedaan, of null. declinedBuyerOffer is het bod van de koper dat de verkoper als laatste heeft afgewezen.

  • Veld: acceptedOffer

    Betekenis: Het bod waarop overeenstemming is bereikt, of null.

  • Veld: leaseToOwn

    Betekenis: De Lease-to-Own-voorwaarden van de verkoper: total, downPayment, finalPayment, installment en het aantal installments; null als die er niet zijn.

  • Veld: feeSplit

    Betekenis: Wie de marktplaatskosten betaalt zoals voorgesteld door elke partij en zoals overeengekomen: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75), buyer_pays_all of null.

  • Veld: amountToPay

    Betekenis: Wat de koper nu betaalt na een overeenkomst, wanneer bekend: bij een prijsafspraak het overeengekomen bedrag plus het deel van de kosten van de koper; bij een Lease-to-Own-overeenkomst de eerste betaling, dat is de aanbetaling, of de eerste termijn als die er niet is (de volledige lease is leaseToOwn.total, en de betaalpagina voegt eventueel het deel van de kosten van de koper toe).

  • Veld: deposit

    Betekenis: Voor een Quality Offer: de state, amount (USD) en expiresAt van de aanbetaling; anders null.

  • Veld: messages[].from

    Betekenis: you, counterparty (de andere partij, voor haar berichten en voor haar biedingen, tegenbiedingen, afwijzingen, intrekkingen en acceptaties), support of system (een gebeurtenis die door geen van beide partijen is gedaan).

  • Veld: messages[].kind

    Betekenis: text, offer, counter_offer, offer_accepted, offer_declined, offer_withdrawn, lease_to_own_proposal, blocked_by_moderation of event. Alleen text-berichten bevatten text.

  • Veld: messages[].offer.state

    Betekenis: active, declined, withdrawn, accepted of superseded.

De tools die een onderhandeling wijzigen (marketplace_offer_make, marketplace_offer_counter, marketplace_offer_accept, marketplace_offer_decline, marketplace_offer_withdraw, marketplace_negotiation_suspend en marketplace_negotiation_restore) geven als antwoord de onderhandeling zoals die na de wijziging opnieuw is gelezen. Als dat lezen mislukt, blijft de wijziging toch van kracht: het antwoord laat leaseToOwn en amountToPay weg en voegt een note toe; lees de onderhandeling met marketplace_negotiation_get om die te zien.

marketplace_negotiation_message_send — Bericht voor marktplaatsonderhandeling verzenden

Toegang: Gevoelige schrijfactie — een verzonden bericht kan niet worden teruggehaald.

Verstuurt een tekstbericht naar de andere partij van een onderhandeling waaraan je deelneemt, als verkoper of koper; de andere partij krijgt een melding. Het antwoord is status: "sent" met het bericht zoals opgeslagen. Wanneer de berichtregels van de marktplaats dit tegenhouden (bijvoorbeeld contactgegevens of betaling buiten Spaceship), is het antwoord het normale resultaat status: "blocked_by_moderation" met een note: er is niets afgeleverd en het bericht moet anders worden geformuleerd voordat het opnieuw wordt verzonden.

Een onderhandeling waarbij je geen partij bent, geeft business.notFound terug, net als een onderhandeling die niet bestaat. Een mislukte aanroep wordt niet automatisch opnieuw geprobeerd: lees de onderhandeling met marketplace_negotiation_get om te zien of het bericht is aangekomen voordat je het opnieuw verzendt.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

  • Parameter: text

    Vereist: Ja

    Type & beperkingen: Platte tekst, 1–2000 tekens na trimmen.

Retourneert

{
"status": "sent",
"message": {
"messageId": "c7d8e9f0-a1b2-4345-9cde-f01234567890",
"from": "you",
"kind": "text",
"text": "The domain is still available.",
"offer": null,
"flagged": false,
"sentAt": "2026-10-26T10:15:00.000Z"
}
}

  • status: sent

    Betekenis: Het bericht is afgeleverd; message is het opgeslagen bericht.

  • status: blocked_by_moderation

    Betekenis: De berichtregels hebben het tegengehouden en er is niets afgeleverd; note vermeldt dat.

marketplace_offer_make — Bod op marktplaats doen

Toegang: Gevoelige schrijfactie — een koper kan een bod niet intrekken, en de verkoper kan het accepteren.

Doet jouw bod, als koper, op een domein dat te koop staat op de Spaceship-marktplaats en opent een onderhandeling met de verkoper, die een melding krijgt. Als je al over dat domein onderhandelt, wordt het bod aan die onderhandeling toegevoegd. Het antwoord is de onderhandeling met status: "offer_sent", of het normale resultaat status: "deposit_required" met een note wanneer de verkoper een terugbetaalbare Quality Offer-aanbetaling vereist: het bod bereikt de verkoper zodra de aanbetaling die wordt getoond in negotiation.deposit is betaald op Spaceship.

Een domein dat niet te koop staat, en je eigen domein, geven business.notFound terug ("The domain is not listed for sale."). Een mislukte aanroep wordt niet automatisch opnieuw geprobeerd: vermeld je onderhandelingen met marketplace_negotiations_list en role: "buyer" om te zien of het bod al is gedaan voordat je opnieuw biedt.

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: Het domein dat te koop staat, bijvoorbeeld example.com. ASCII-domeinnaam, 3–253 tekens; hoofdletterongevoelig vergeleken.

  • Parameter: amount

    Vereist: Ja

    Type & beperkingen: Jouw bod in Amerikaanse dollars als een decimale tekenreeks met maximaal 2 decimalen, bijvoorbeeld "2500". Moet groter zijn dan 0 en maximaal 10,000,000.

Retourneert — negotiation heeft de vorm die wordt beschreven onder marketplace_negotiation_get:

{
"status": "deposit_required",
"note": "The seller requires a refundable Quality Offer deposit for this domain. The offer reaches the seller once the deposit shown in `negotiation.deposit` is paid on Spaceship.",
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "buyer",
"status": "contact_request",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-26T10:15:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": null, "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": { "state": "charge_pending", "amount": { "amount": "250.00", "currency": "USD" }, "expiresAt": "2026-11-02T10:15:00.000Z" },
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

  • status: offer_sent

    Betekenis: Het bod is gedaan en de verkoper is op de hoogte gebracht.

  • status: deposit_required

    Betekenis: Het bod wacht tot de Quality Offer-aanbetaling in negotiation.deposit is betaald.

marketplace_offer_counter — Tegenbod op marktplaats doen

Toegang: Gevoelige schrijfactie — de andere partij kan dit accepteren als een bindende overeenkomst.

Doet een tegenbod in een onderhandeling waaraan je deelneemt, als verkoper of koper: ofwel een amount in Amerikaanse dollars of, alleen als verkoper, Lease-to-Own-voorwaarden in leaseToOwn; de andere partij krijgt een melding. Stelt optioneel voor wie de marktplaatskosten betaalt met feeSplit. Het antwoord is de bijgewerkte onderhandeling. Het Lease-to-Own-totaal is de som van de aanbetaling, de termijnen en de slotbetaling.

Zowel amount als leaseToOwn doorgeven, of geen van beide, wordt afgewezen voordat er iets wordt verzonden. Lease-to-Own-voorwaarden van de koper geven business.invalidArgument terug ("Only the seller can propose Lease-to-Own terms."). Een onderhandeling waarbij je geen partij bent, geeft business.notFound terug. Een mislukte aanroep wordt niet automatisch opnieuw geprobeerd: lees de onderhandeling met marketplace_negotiation_get om te zien of het tegenbod al is gedaan voordat je opnieuw een tegenbod doet.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

  • Parameter: amount

    Vereist: Voorwaardelijk

    Type & beperkingen: Vereist tenzij leaseToOwn is opgegeven; nooit samen ermee. USD-decimale tekenreeks met maximaal 2 decimalen, groter dan 0 en maximaal 10,000,000.

  • Parameter: leaseToOwn

    Vereist: Voorwaardelijk

    Type & beperkingen: Alleen verkoper. Vereist tenzij amount is opgegeven; nooit samen ermee. Object met de onderstaande velden.

  • Parameter: leaseToOwn.installmentAmount

    Vereist: Ja (in leaseToOwn)

    Type & beperkingen: Bedrag van elke maandelijkse termijn, USD-decimale tekenreeks.

  • Parameter: leaseToOwn.installments

    Vereist: Ja (in leaseToOwn)

    Type & beperkingen: Geheel getal 1–120; minimaal 2 zonder een downPayment.

  • Parameter: leaseToOwn.downPayment

    Vereist: Nee

    Type & beperkingen: Aanbetaling, eerst betaald, USD-decimale tekenreeks. Laat weg als er geen is.

  • Parameter: leaseToOwn.finalPayment

    Vereist: Nee

    Type & beperkingen: Slotbetaling, als laatste betaald, USD-decimale tekenreeks. Laat weg als er geen is.

  • Parameter: feeSplit

    Vereist: Nee

    Type & beperkingen: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75) of buyer_pays_all. Laat weg om de huidige verdeling te behouden.

Retourneert — { "negotiation": { ... } }, de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get, met je nieuwe bod in buyerOffer of sellerOffer:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": { "amount": "4000.00", "currency": "USD", "madeAt": "2026-10-26T10:15:00.000Z" },
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": "even_split", "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

marketplace_offer_accept — Bod op marktplaats accepteren

Toegang: Gevoelige schrijfactie — bereikt een bindende overeenkomst die niet ongedaan kan worden gemaakt.

Accepteert het meest recente bod van de andere partij in een onderhandeling waaraan je deelneemt: als verkoper het meest recente bod van de koper; als koper het Lease-to-Own-voorstel van de verkoper wanneer dat er is, anders het meest recente tegenbod van de verkoper. Hiermee wordt een bindende overeenkomst bereikt en dit kan niet ongedaan worden gemaakt. Alleen een bod dat de andere partij heeft gedaan na jouw eigen meest recente actie kan worden geaccepteerd: wanneer jij als verkoper je eigen openstaande tegenbod of Lease-to-Own-voorstel hebt, trek dit dan eerst in met marketplace_offer_withdraw. De tool trekt dit niet voor je in; een acceptatie die wordt verzonden terwijl jouw eigen actie de meest recente is, geeft business.conflict terug ("There is no offer from the other side that can be accepted now.") en verandert niets.

Bevestiging in twee stappen. De eerste aanroep verandert niets en geeft status: "confirmation_required" terug met een confirmation (een summary-zin, het domain en het offer) en een confirmationToken. Toon de samenvatting aan de gebruiker en roep, zodra die akkoord gaat, opnieuw aan met dezelfde negotiationId, de token en confirmationResponse: "accept"; "decline" geeft status: "cancelled" terug en verandert niets. Een token die is verlopen, bij een ander account hoort of is uitgegeven voor een bod dat sindsdien is gewijzigd, krijgt een nieuwe confirmation_required in plaats van een acceptatie. Wanneer de andere partij geen bod heeft om te accepteren, is het antwoord business.conflict ("There is no offer from the other side to accept."); een onderhandeling waarbij je geen partij bent, geeft business.notFound terug.

Wanneer de uitkomst onbekend is, is het antwoord infrastructure.outcomeUnknown: de overeenkomst kan wel of niet zijn bereikt. Herhaal de aanroep niet: lees eerst de onderhandeling met marketplace_negotiation_get om te zien of de overeenkomst is bereikt.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: Tekenreeks, maximaal 4096 tekens. De token van een eerdere aanroep van marketplace_offer_accept voor deze onderhandeling. Laat weg bij de eerste aanroep. Verloopt na korte tijd en is gekoppeld aan het bod waarvoor deze is uitgegeven.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: "accept" of "decline". Alleen zinvol met een geldige confirmationToken: "accept" accepteert het bod, "decline" annuleert zonder iets te wijzigen. Laat weg bij de eerste aanroep.

Retourneert — na de eerste aanroep (er is niets gewijzigd):

{
"status": "confirmation_required",
"confirmationToken": "<opaque confirmation token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_offer_accept again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Accepting the offer of 2500.00 USD from the buyer for example.com reaches a binding agreement that cannot be undone. With this offer, the seller pays the whole marketplace fee. Accepting charges nothing: the buyer then pays the agreed amount through a Spaceship payment link, which shows the fees and the final amount before payment.",
"domain": "example.com",
"offer": { "kind": "price", "price": { "amount": "2500.00", "currency": "USD" }, "feeSplit": "seller_pays_all", "leaseToOwn": null }
}
}

offer.kind is price of lease_to_own; voor lease_to_own is price het totaal van het voorstel en bevat leaseToOwn de betalingen ervan (total, downPayment, finalPayment, installment, installments), wat ook in de samenvatting staat; anders is leaseToOwnnull. feeSplit is de verdeling van de marktplaatskosten die de andere partij met het bod heeft voorgesteld (de huidige verdeling van de onderhandeling wanneer er geen is voorgesteld), een van de feeSplit-waarden die worden vermeld onder marketplace_negotiation_get, of null wanneer er geen bekend is; in dat geval laat de samenvatting dit weg. Na confirmationResponse: "accept" is het antwoord { "status": "accepted", "negotiation": { ... } } met de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get.

  • status: confirmation_required

    Betekenis: Er is niets geaccepteerd; bevestig met de confirmationToken

  • status: cancelled

    Betekenis: confirmationResponse: "decline"; er is niets gewijzigd.

  • status: accepted

    Betekenis: Het bod is geaccepteerd en de overeenkomst is bereikt.

marketplace_offer_decline — Bod op marktplaats afwijzen

Toegang: Gevoelige schrijfactie — de koper krijgt een melding en de afwijzing kan niet worden teruggedraaid.

Wijst als verkoper het meest recente bod van de koper af in een onderhandeling over jouw vermelding; de koper krijgt een melding en kan nog steeds een nieuw bod doen. Het antwoord is de bijgewerkte onderhandeling. Alleen de verkoper kan afwijzen: de koper krijgt business.invalidArgument ("Only the seller can decline an offer."), en een onderhandeling waarbij je geen partij bent, geeft business.notFound terug.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

Retourneert — { "negotiation": { ... } }, de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get; het afgewezen bod staat niet langer in buyerOffer:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": null,
"sellerOffer": null,
"declinedBuyerOffer": { "amount": "2500.00", "currency": "USD" },
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": null, "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

marketplace_offer_withdraw — Tegenbod op marktplaats intrekken

Toegang: Gevoelige schrijfactie — de koper krijgt een melding en de intrekking kan niet worden teruggedraaid.

Trekt als verkoper je eigen openstaande tegenbod of Lease-to-Own-voorstel in (annuleert het) in een onderhandeling over jouw vermelding; de koper krijgt een melding, diens meest recente bod blijft staan en de onderhandeling blijft open. Dit is wat "cancel my offer" betekent; het annuleren van de hele onderhandeling is marketplace_negotiation_suspend. Het antwoord is de bijgewerkte onderhandeling. Wanneer je geen openstaand tegenbod of voorstel hebt, is het antwoord business.conflict ("There is no pending counter-offer or Lease-to-Own proposal to withdraw.") en wordt er niets gewijzigd; dit wordt alleen gegeven wanneer de onderhandeling geen bod of voorstel van jou toont, of wanneer al je berichten daarin zijn gecontroleerd. In een zeer lange onderhandeling worden mogelijk niet al je berichten op tijd gecontroleerd. De aanroep geeft dan het normale resultaat { "status": "lookup_incomplete", "withdrawn": false, "note": "The negotiation's messages could not all be checked in time for your pending counter-offer or Lease-to-Own proposal, so nothing was withdrawn and the negotiation is unchanged." } terug, er wordt niets gewijzigd en je kunt opnieuw aanroepen. Alleen de verkoper kan intrekken: de koper krijgt business.invalidArgument ("Only the seller can withdraw a counter-offer."), en een onderhandeling waarbij je geen partij bent, geeft business.notFound terug.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

Retourneert — { "negotiation": { ... } }, de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get, waarbij het meest recente bod van de koper blijft staan:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

marketplace_negotiation_suspend — Marktplaatsonderhandeling annuleren (opschorten)

Toegang: Gevoelige schrijfactie — de koper krijgt direct een melding, elk open bod wordt gesloten en een Quality Offer-aanbetaling of makelaarscommissie wordt afgehandeld; een herstel brengt die niet terug.

Annuleert als verkoper een volledige onderhandeling over jouw vermelding ("Cancel lead" in SellerHub): de koper krijgt een melding en kan geen biedingen meer doen, elk open bod daarin wordt gesloten en een Quality Offer-aanbetaling of makelaarscommissie daarin wordt afgehandeld. Alleen je eigen openstaande tegenbod of Lease-to-Own-voorstel intrekken is marketplace_offer_withdraw, waardoor de onderhandeling open blijft. marketplace_negotiation_restore opent deze opnieuw, maar brengt de biedingen, de aanbetaling of de makelaarscommissie niet terug. Het antwoord is de bijgewerkte onderhandeling. Alleen de verkoper kan dit doen: de koper krijgt business.invalidArgument ("Only the seller can suspend a negotiation."), en een onderhandeling waarbij je geen partij bent, geeft business.notFound terug.

Bevestiging in twee stappen. De eerste aanroep verandert niets en geeft status: "confirmation_required" terug met een confirmation (een summary-zin en het domain) en een confirmationToken. Toon de samenvatting aan de gebruiker en roep, zodra die akkoord gaat, opnieuw aan met dezelfde negotiationId, de token en confirmationResponse: "accept"; "decline" geeft status: "cancelled" terug en verandert niets. Een token die is verlopen of bij een ander account hoort, krijgt een nieuwe confirmation_required in plaats van een annulering.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: String, maximaal 4096 tekens. De token van een eerdere aanroep van marketplace_negotiation_suspend voor deze onderhandeling. Laat weg bij de eerste aanroep. Verloopt na korte tijd.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: "accept" of "decline". Alleen zinvol met een geldige confirmationToken: "accept" annuleert de onderhandeling, "decline" verandert niets. Laat weg bij de eerste aanroep.

Retourneert — na de eerste aanroep (er is niets gewijzigd):

{
"status": "confirmation_required",
"confirmationToken": "<opaque confirmation token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_negotiation_suspend again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Cancel the negotiation on example.com? The buyer is notified and can no longer make offers, every open offer in it closes, and a Quality Offer deposit or broker commission in it is settled. It can be restored later with marketplace_negotiation_restore, but a restore does not bring back the offers, the deposit or the broker commission.",
"domain": "example.com"
}
}

Na de geaccepteerde tweede aanroep — { "negotiation": { ... } }, de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "suspended",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": true,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

marketplace_negotiation_restore — Marketplace-onderhandeling herstellen

Toegang: Schrijven.

Herstelt als verkoper een opgeschorte onderhandeling op je vermelding; de koper krijgt bericht en de onderhandeling gaat verder waar deze was gestopt. Het antwoord is de bijgewerkte onderhandeling. Alleen de verkoper kan herstellen: de koper krijgt business.invalidArgument ("Only the seller can restore a negotiation."), en een onderhandeling waarbij je geen partij bent geeft business.notFound.

  • Parameter: negotiationId

    Vereist: Ja

    Type & beperkingen: UUID van de onderhandeling, zoals geretourneerd door marketplace_negotiations_list of marketplace_negotiation_get.

Retourneert — { "negotiation": { ... } }, de onderhandeling in de vorm die wordt beschreven onder marketplace_negotiation_get:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:20:00.000Z"
}
}

SafePay-deals, lease-to-own-overeenkomsten waar je deel van uitmaakt, en zoeken in wat andere verkopers aanbieden.

marketplace_safepay_deals_list — SafePay-deals weergeven

Toegang: Lezen.

Geeft je SafePay-deals weer, nieuwste eerst, als verkoper, koper of beide, optioneel gefilterd op status of op een deel van de domeinnaam. Elke deal bevat de status, prijs, wie wat betaalt en je rol daarin. Lees de deal met marketplace_safepay_deal_get voor de volgende stap van een deal en je link ernaartoe.

Zonder role worden de deals waarin je de verkoper bent en de deals waarin je de koper bent samengevoegd, nieuwste eerst, elk gelabeld met je role, en total telt beide mee. In die modus zijn alleen de eerste 100 deals bereikbaar: limit plus offset mag niet hoger zijn dan 100. Beide kanten worden binnen één tijdslimiet gelezen: als één kant niet op tijd kan worden gelezen, bevat het antwoord de deals van de andere kant, telt total alleen die kant, en noemt unavailable de kant die niet is gelezen (["seller"] of ["buyer"]); unavailable wordt weggelaten wanneer elke kant is gelezen. Als geen van de gevraagde kanten op tijd kan worden gelezen, mislukt de aanroep met infrastructure.serviceUnavailable ("The marketplace did not answer in time."). Een filter dat niets oplevert, geeft een lege lijst terug, geen fout. De contactgegevens van de andere partij worden nooit geretourneerd.

  • Parameter: role

    Vereist: Nee

    Type & beperkingen: seller of buyer: alleen deals waarin je deze partij bent. Laat weg voor beide (dan limit + offset ≤ 100).

  • Parameter: status

    Vereist: Nee

    Type & beperkingen: Array van 1–10 verschillende statussen: active, pending_seller_confirm, pending_buyer_confirm, pending_seller_reconfirm, awaiting_payment, processing, verification, purchased, deactivated, expired.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: String, 4–253 tekens. Alleen deals waarvan de domeinnaam deze tekst bevat.

  • Parameter: limit

    Vereist: Nee

    Type & beperkingen: Integer, 1–50. Standaard 20.

  • Parameter: offset

    Vereist: Nee

    Type & beperkingen: Integer, 0 of meer. Standaard 0.

Retourneert — { items, total }, waarbij total het aantal overeenkomende deals is, niet de paginagrootte:

{
"items": [
{
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_seller_confirm",
"type": "buy_now",
"openedBy": "buyer",
"price": { "amount": "1000.00", "currency": "USD" },
"buyerPays": { "amount": "1050.00", "currency": "USD" },
"sellerReceives": { "amount": "1000.00", "currency": "USD" },
"paymentMethod": "credit_card",
"createdAt": "2026-10-26T10:00:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"negotiationId": null
}
],
"total": 7
}

  • Veld: role

    Betekenis: Jouw kant in de deal: seller of buyer.

  • Veld: type

    Betekenis: buy_now, lease_to_own of make_offer.

  • Veld: openedBy

    Betekenis: Wie de deal heeft geopend: seller, buyer of broker.

  • Veld: price, buyerPays, sellerReceives

    Betekenis: { amount, currency }, of null wanneer niet ingesteld.

  • Veld: paymentMethod

    Betekenis: credit_card, paypal, account_funds, btc_pay, wire_transfer, alipay, of null wanneer er nog geen is gekozen.

  • Veld: validUntil

    Betekenis: Wanneer de deal verloopt als deze dan niet is voltooid.

  • Veld: negotiationId

    Betekenis: De marketplace-onderhandeling waaruit de deal is voortgekomen, of null.

  • Veld: unavailable

    Betekenis: Alleen wanneer een kant niet op tijd kon worden gelezen: ["seller"] of ["buyer"].

marketplace_safepay_deal_get — SafePay-deal ophalen

Toegang: Lezen.

Leest een van je SafePay-deals op id: de status, voorwaarden, wie wat betaalt, je rol, de volgende stap voor jou, je eigen link naar de deal en counterpartyLink, de link van de andere partij om naar hen te sturen. De contactgegevens van de andere partij (email, telefoon, account-id) worden nooit geretourneerd.

Een deal waarbij je geen partij bent geeft business.notFound (The SafePay deal was not found.), precies zoals een deal die niet bestaat, dus het antwoord vertelt nooit of een deal-id van iemand anders is. Een id die geen UUID is, wordt afgewezen met application.request.badRequest.

  • Parameter: dealId

    Vereist: Ja

    Type & beperkingen: UUID van de deal, zoals geretourneerd door marketplace_safepay_deals_list.

Retourneert — { "deal": { ... } }:

{
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_seller_confirm",
"type": "buy_now",
"openedBy": "buyer",
"price": { "amount": "1000.00", "currency": "USD" },
"totalPrice": { "amount": "1050.00", "currency": "USD" },
"buyerPays": { "amount": "1050.00", "currency": "USD" },
"sellerReceives": { "amount": "1000.00", "currency": "USD" },
"feeSplit": "buyer_pays_all",
"paymentMethod": "credit_card",
"canChangePaymentMethod": false,
"needsSellerReconfirmation": false,
"leaseTerms": null,
"createdAt": "2026-10-26T10:00:00.000Z",
"updatedAt": "2026-10-26T10:05:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"domainExpiresAt": "2027-10-28T10:00:00.000Z",
"domainExpiresSoon": false,
"negotiationId": null,
"link": "https://www.spaceship.com/safepay/...",
"counterpartyLink": "https://www.spaceship.com/safepay/...",
"nextStep": "You need to confirm the terms before the deal can go ahead."
}
}

  • Veld: role

    Betekenis: Jouw kant in de deal: seller of buyer.

  • Veld: status

    Betekenis: Een van de statussen die worden vermeld onder marketplace_safepay_deals_list.

  • Veld: type / openedBy

    Betekenis: Zoals in marketplace_safepay_deals_list.

  • Veld: price / totalPrice

    Betekenis: De dealprijs en het totaal inclusief de SafePay-vergoeding; { amount, currency } of null.

  • Veld: buyerPays / sellerReceives

    Betekenis: Wat elke partij betaalt of ontvangt na de vergoeding; { amount, currency } of null.

  • Veld: feeSplit

    Betekenis: Wie de SafePay-vergoeding betaalt, met dezelfde waarden als onderhandelingen gebruiken: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75), buyer_pays_all, of null.

  • Veld: paymentMethod

    Betekenis: De betaalmethode van de koper, of null. canChangePaymentMethod geeft aan of deze nog kan worden gewijzigd.

  • Veld: needsSellerReconfirmation

    Betekenis: true wanneer de verkoper de voorwaarden opnieuw moet bevestigen.

  • Veld: leaseTerms

    Betekenis: Voor een lease-to-own-deal: { total, downPayment, installment, installments } (downPayment mag null zijn); anders null.

  • Veld: validUntil

    Betekenis: Wanneer de deal verloopt als deze dan niet is voltooid; dezelfde datum die marketplace_safepay_deals_list geeft.

  • Veld: domainExpiresAt / domainExpiresSoon

    Betekenis: Wanneer de registratie van het domein zelf verloopt (of null wanneer onbekend of buiten Spaceship geregistreerd), en true wanneer de registratie al in redemption is of wordt verwijderd. Dit is niet de vervaldatum van de deal.

  • Veld: link

    Betekenis: Je eigen link naar de deal, waar de koper betaalt.

  • Veld: counterpartyLink

    Betekenis: De link van de andere partij naar de deal, om naar hen te sturen (voor een deal die je als verkoper hebt geopend, de link van de koper, waar de koper betaalt).

  • Veld: nextStep

    Betekenis: Eén zin die je vertelt wat er vanaf jouw kant hierna gebeurt, bijvoorbeeld Waiting for the buyer to confirm the terms.

marketplace_safepay_deal_create — SafePay-deal openen

Toegang: Gevoelig schrijven — opent een deal die de andere partij als bindend kan accepteren.

Opent een SafePay-deal voor een domein, als verkoper (voor een domein dat je bezit) of als koper (voor een domein dat iemand anders bezit). Het openen van een deal kost niets: de andere partij krijgt bericht en moet de voorwaarden nog bevestigen, en de koper betaalt daarna via de deallink. Kies elke voorwaarde samen met de gebruiker: de prijs, wie de SafePay-vergoeding betaalt en, voor lease_to_own, de aanbetaling en het aantal termijnen. Niets wordt voor je ingevuld.

Voordat de deal wordt geopend, zoekt de tool naar een deal van jou, in dezelfde rol, voor hetzelfde domein, die een nieuwe blokkeert: een deal die active, awaiting_payment, processing of verification is, of een nog niet bevestigde deal (een status pending_*) tegen dezelfde prijs, wat hoogstwaarschijnlijk dezelfde deal is die door een eerdere aanroep is geopend. Een nog niet bevestigde deal tegen een andere prijs blokkeert geen nieuwe, net als in SellerHub. Als er een blokkerende deal bestaat, wordt er geen tweede deal geopend en is het antwoord een normaal resultaat met status: "already_open", die deal en een opmerking. Als die opzoeking niet kan worden voltooid, wordt de deal geopend zoals dat zonder die opzoeking zou gebeuren.

De counterpartyEmail wordt alleen gebruikt om de andere partij op de hoogte te stellen: deze wordt nooit teruggegeven in het antwoord. Inconsistente voorwaarden (een prijs met meer dan twee decimalen, leasevoorwaarden die ontbreken of bij een buy_now-deal staan, een koper zonder counterpartyEmail of paymentMethod, een verkoper met paymentMethod) worden geweigerd met business.invalidArgument en een vermelding in validationErrors per veld, voordat er iets wordt verzonden. Een weigering van SafePay zelf, bijvoorbeeld wanneer het domein al een overeengekomen deal heeft, geeft business.conflict. Als de aanroep mislukt met infrastructure.serviceUnavailable of infrastructure.outcomeUnknown, kan de deal zijn geopend: geef je deals weer met marketplace_safepay_deals_list voordat je deze opnieuw opent.

  • Parameter: role

    Vereist: Ja

    Type & beperkingen: seller (je bezit het domein) of buyer (iemand anders bezit het).

  • Parameter: domain

    Vereist: Ja

    Type & beperkingen: String, 4–253 tekens. Accepteert Unicode (IDN) of ASCII (A-label), genormaliseerd naar punycode.

  • Parameter: type

    Vereist: Ja

    Type & beperkingen: buy_now (een eenmalige betaling van de prijs) of lease_to_own (betaald in termijnen).

  • Parameter: price

    Vereist: Ja

    Type & beperkingen: USD-bedrag als een decimale string met maximaal twee decimalen, groter dan 0 en maximaal 10000000, bijvoorbeeld "1500.00". Voor lease_to_own is dit het totale leasebedrag.

  • Parameter: feePaidBy

    Vereist: Ja

    Type & beperkingen: Wie de SafePay-vergoeding betaalt: seller (alles), seller_pays_most (verkoper 75%, koper 25%), split (ieder de helft), buyer_pays_most (verkoper 25%, koper 75%) of buyer (alles).

  • Parameter: ltoDownPaymentPercent

    Vereist: Voorwaardelijk

    Type & beperkingen: Integer, 0–99: aanbetaling als percentage van het totale leasebedrag. Vereist voor lease_to_own, niet toegestaan voor buy_now.

  • Parameter: ltoInstallments

    Vereist: Voorwaardelijk

    Type & beperkingen: Integer, 1–120: aantal termijnen. Vereist voor lease_to_own, niet toegestaan voor buy_now.

  • Parameter: counterpartyEmail

    Vereist: Voorwaardelijk

    Type & beperkingen: E-mailadres van de andere partij, maximaal 254 tekens; zij krijgen bericht over de deal. Vereist wanneer rolebuyer is, optioneel wanneer roleseller is. Wordt nooit geretourneerd in het antwoord.

  • Parameter: paymentMethod

    Vereist: Voorwaardelijk

    Type & beperkingen: credit_card, paypal, account_funds, btc_pay, wire_transfer of alipay: de methode waarmee de koper zal betalen. Vereist wanneer rolebuyer is; optioneel wanneer roleseller is, die deze vooraf voor de koper kan kiezen.

Retourneert — een nieuw geopende deal:

{
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_buyer_confirm",
"type": "buy_now",
"price": { "amount": "1500.00", "currency": "USD" },
"feePaidBy": "buyer",
"link": "https://www.spaceship.com/safepay/...",
"counterpartyLink": "https://www.spaceship.com/safepay/...",
"nextStep": "Waiting for the buyer to confirm the terms."
}
}

feePaidBy is null wanneer de verdeling van de dealvergoeding niet een van de vijf feePaidBy-waarden is. link is je eigen link naar de deal en counterpartyLink die van de andere partij, om naar hen te sturen.

Wanneer je al een open deal voor het domein in die rol hebt, heeft de deal de vorm die marketplace_safepay_deals_list retourneert:

{
"status": "already_open",
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_buyer_confirm",
"type": "buy_now",
"openedBy": "seller",
"price": { "amount": "1500.00", "currency": "USD" },
"buyerPays": { "amount": "1575.00", "currency": "USD" },
"sellerReceives": { "amount": "1500.00", "currency": "USD" },
"paymentMethod": null,
"createdAt": "2026-10-26T10:00:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"negotiationId": null
},
"note": "You already have an open SafePay deal for this domain, so no new deal was opened. Read it with marketplace_safepay_deal_get."
}

marketplace_safepay_deal_confirm — SafePay-deal bevestigen

Toegang: Gevoelig schrijven — bereikt een bindende overeenkomst.

Bevestigt de voorwaarden van een SafePay-deal die door de andere partij is geopend en op jouw bevestiging wacht: de verkoper bevestigt een deal die de koper heeft geopend (of bevestigt opnieuw nadat de koper de betaalmethode heeft gewijzigd), de koper bevestigt een deal die de verkoper heeft geopend en kan de betaalmethode kiezen. Bevestigen kost niets; de koper betaalt daarna via de deallink.

Bevestiging in twee stappen. De eerste aanroep verandert niets en geeft status: "confirmation_required" terug met een summary van de voorwaarden (het domein, jouw rol, een eenmalige betaling of de termijnen, wat de koper betaalt en de verkoper ontvangt, en de betaalmethode die je hebt gekozen) en een confirmationToken. Toon de samenvatting aan de gebruiker en roep daarna opnieuw aan met dezelfde argumenten, het token en confirmationResponse: "accept" om te bevestigen, of "decline" om te stoppen; decline geeft status: "cancelled" terug en verandert niets. Het token verloopt na korte tijd en is gebonden aan de argumenten en aan de voorwaarden van de deal op het moment dat het werd uitgegeven: als het verouderd is, of als de prijs, bedragen, verdeling van de kosten, betaalmethode of status intussen is gewijzigd, geeft de aanroep een nieuwe confirmation_required terug in plaats van te bevestigen.

  • Een deal waarbij je geen partij bent, geeft business.notFound terug, precies zoals een deal die niet bestaat.

  • Een deal die niet op jouw bevestiging wacht, geeft business.conflict terug. Dit omvat ook een deal die wacht op bevestiging van de andere partij.

  • Een paymentMethod die door de verkoper is verzonden, of door een koper die een deal bevestigt die hij zelf heeft geopend, wordt geweigerd met business.invalidArgument.

  • Na infrastructure.serviceUnavailable of infrastructure.outcomeUnknown kan de deal bevestigd zijn. Lees deze met marketplace_safepay_deal_get voordat je opnieuw bevestigt.

  • Parameter: dealId

    Vereist: Ja

    Type & beperkingen: UUID van de deal, zoals geretourneerd door marketplace_safepay_deals_list.

  • Parameter: paymentMethod

    Vereist: Nee

    Type & beperkingen: credit_card, paypal, account_funds, btc_pay, wire_transfer of alipay. Alleen de koper kan deze instellen, en alleen bij het bevestigen van een deal die door de verkoper is geopend.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: String, maximaal 4096 tekens, geretourneerd door een eerdere aanroep van deze tool voor exact deze argumenten. Weglaten bij de eerste aanroep; ongewijzigd opnieuw verzenden samen met confirmationResponse.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: accept of decline. Alleen zinvol samen met een geldige confirmationToken. Weglaten bij de eerste aanroep.

Retourneert — na de eerste aanroep (niets bevestigd):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ...",
"note": "Er is nog niets gewijzigd. Toon de bevestiging aan de gebruiker en roep, zodra die akkoord gaat, marketplace_safepay_deal_confirm opnieuw aan met deze confirmationToken en confirmationResponse=\"accept\", of met confirmationResponse=\"decline\" om te annuleren.",
"summary": "Bevestig de SafePay-deal voor greatdomain.com als verkoper: een eenmalige betaling. De koper betaalt USD 1050.00. De verkoper ontvangt USD 1000.00. Door te bevestigen verbind je je aan deze voorwaarden; de betaling zelf wordt afzonderlijk gedaan via de deallink."
}

Na accept, { "deal": { ... } } in de vorm die marketplace_safepay_deal_get retourneert, met de nieuwe status (bijvoorbeeld active of awaiting_payment) en de bijbehorende nextStep. Na decline:

{ "status": "cancelled", "note": "Er is niets gewijzigd omdat de actie niet is bevestigd." }

  • status: confirmation_required

    Betekenis: Er is nog niets gewijzigd; toon summary en roep opnieuw aan met het token.

  • status: cancelled

    Betekenis: Je hebt geweigerd; er is niets gewijzigd.

marketplace_leases_list — Leases weergeven

Toegang: Lezen.

Geeft de lease-to-own-overeenkomsten weer waar jij deel van uitmaakt, nieuwste eerst: de domeinen die je least als koper en de domeinen die je least als verkoper. Elke lease bevat de status, wat is betaald en wat nog over is, de termijnen en de volgende betaling.

Zonder role worden beide kanten samengevoegd, nieuwste eerst, elke lease gelabeld met jouw role, en total telt beide; in die modus mogen limit plus offset niet hoger zijn dan 100. Beide kanten worden binnen één tijdslimiet gelezen: wanneer één kant niet op tijd kan worden gelezen, bevat het antwoord de leases van de andere kant, telt total alleen die kant, en noemt unavailable de kant die niet is gelezen (["seller"] of ["buyer"]); unavailable wordt weggelaten wanneer elke kant is gelezen. Wanneer geen van de gevraagde kanten op tijd kon worden gelezen, mislukt de aanroep met infrastructure.serviceUnavailable ("De marketplace antwoordde niet op tijd."). Een filter dat niets oplevert, geeft een lege lijst terug, geen fout. De accountgegevens van de andere partij worden nooit geretourneerd.

  • Parameter: role

    Vereist: Nee

    Type & beperkingen: buyer (de domeinen die je least) of seller (de domeinen die je verleast). Weglaten voor beide (dan limit + offset ≤ 100).

  • Parameter: state

    Vereist: Nee

    Type & beperkingen: Array van 1–5 verschillende statussen: active, cancelling, cancelled, failed_payment, completed.

  • Parameter: domain

    Vereist: Nee

    Type & beperkingen: String, 1–253 tekens. Alleen leases waarvan de domeinnaam deze tekst bevat.

  • Parameter: limit

    Vereist: Nee

    Type & beperkingen: Integer, 1–50. Standaard 20.

  • Parameter: offset

    Vereist: Nee

    Type & beperkingen: Integer, 0 of meer. Standaard 0.

Retourneert — { items, total }:

{
"items": [
{
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"role": "buyer",
"state": "active",
"total": { "amount": "1200.00", "currency": "USD" },
"paid": { "amount": "300.00", "currency": "USD" },
"left": { "amount": "900.00", "currency": "USD" },
"percentPaid": 25,
"isPaidOff": false,
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12,
"installmentsPaid": 3,
"downPayment": { "amount": "120.00", "currency": "USD" },
"finalPayment": null,
"nextPayment": {
"amount": { "amount": "100.00", "currency": "USD" },
"date": "2026-11-01T10:00:00.000Z",
"type": "installment"
},
"lastPaymentDate": "2026-10-01T10:00:00.000Z",
"cancellationReason": null,
"canceledAt": null,
"createdAt": "2026-08-01T10:00:00.000Z",
"negotiationId": "6f1d1c2e-3b4a-4c5d-8e9f-0a1b2c3d4e5f"
}
],
"total": 9
}

  • Veld: role

    Betekenis: Jouw kant: buyer of seller.

  • Veld: state

    Betekenis: active, cancelling, cancelled, failed_payment of completed.

  • Veld: total / paid / left

    Betekenis: Het totaalbedrag van de lease, het tot nu toe betaalde bedrag en het resterende bedrag; percentPaid is het betaalde aandeel in procenten.

  • Veld: installment / installments / installmentsPaid

    Betekenis: Het bedrag van één termijn, hoeveel er zijn en hoeveel er betaald zijn.

  • Veld: downPayment / finalPayment

    Betekenis: { amount, currency }, of null wanneer de lease die niet heeft.

  • Veld: nextPayment.type

    Betekenis: down_payment, installment, final_payment, paid_off of unknown.

  • Veld: cancellationReason

    Betekenis: seller_cancelled, buyer_cancelled, support_cancelled, of null; canceledAt wordt daarmee ingesteld.

  • Veld: negotiationId

    Betekenis: De marketplace-onderhandeling waaruit de lease is voortgekomen.

  • Veld: unavailable

    Betekenis: Alleen wanneer een kant niet op tijd kon worden gelezen: ["seller"] of ["buyer"].

marketplace_lease_get — Lease ophalen

Toegang: Lezen.

Leest één lease-to-own-overeenkomst waar jij deel van uitmaakt op id: de status, het betaalde en resterende bedrag, de termijnen, de volgende betaling en jouw rol daarin. Gebruik dit om de status van een lease te volgen, bijvoorbeeld terwijl deze van cancelling naar cancelled gaat.

Een lease waarbij je geen partij bent, geeft business.notFound terug (The lease was not found.), precies zoals een lease die niet bestaat.

  • Parameter: leaseId

    Vereist: Ja

    Type & beperkingen: UUID van de lease, zoals geretourneerd door marketplace_leases_list.

Retourneert — { "lease": { ... } }, één lease in de vorm die marketplace_leases_list retourneert:

{
"lease": {
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"role": "buyer",
"state": "active",
"total": { "amount": "1200.00", "currency": "USD" },
"paid": { "amount": "300.00", "currency": "USD" },
"left": { "amount": "900.00", "currency": "USD" },
"percentPaid": 25,
"isPaidOff": false,
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12,
"installmentsPaid": 3,
"downPayment": { "amount": "120.00", "currency": "USD" },
"finalPayment": null,
"nextPayment": {
"amount": { "amount": "100.00", "currency": "USD" },
"date": "2026-11-01T10:00:00.000Z",
"type": "installment"
},
"lastPaymentDate": "2026-10-01T10:00:00.000Z",
"cancellationReason": null,
"canceledAt": null,
"createdAt": "2026-08-01T10:00:00.000Z",
"negotiationId": "6f1d1c2e-3b4a-4c5d-8e9f-0a1b2c3d4e5f"
}
}

marketplace_lease_cancel — Lease annuleren

Toegang: Gevoelige schrijfactie — kan niet ongedaan worden gemaakt; reeds betaalde bedragen worden niet terugbetaald.

Annuleert een lease-to-own-overeenkomst als koper. De resterende termijnen stoppen, reeds betaalde bedragen worden niet terugbetaald en het domein gaat terug naar de verkoper. Dit kan hier niet ongedaan worden gemaakt. Alleen de koper kan annuleren, en alleen een active lease.

Bevestiging in twee stappen. De eerste aanroep verandert niets en geeft status: "confirmation_required" terug met een summary (het domein, wat je hebt betaald, wat nog over is, en dat betaalde bedragen niet worden terugbetaald) en een confirmationToken. Toon de samenvatting aan de gebruiker en roep daarna opnieuw aan met dezelfde leaseId, het token en confirmationResponse: "accept" om te annuleren, of "decline" om te stoppen; decline geeft status: "cancelled" terug en verandert niets. Het token verloopt na korte tijd en is gebonden aan de lease zoals die was toen het token werd uitgegeven: als het verouderd is, of als er intussen een termijn is betaald, geeft de aanroep een nieuwe confirmation_required terug in plaats van te annuleren.

Een lease waarbij je geen partij bent, geeft business.notFound terug, precies zoals een lease die niet bestaat. Als verkoper krijg je business.conflict (Only the buyer can cancel a lease.), en een lease die niet active is, geeft business.conflict terug (The lease is not active, so it cannot be cancelled.). Als de aanroep mislukt met infrastructure.serviceUnavailable of infrastructure.outcomeUnknown, kan de lease geannuleerd zijn: lees deze met marketplace_lease_get voordat je opnieuw annuleert.

  • Parameter: leaseId

    Vereist: Ja

    Type & beperkingen: UUID van de lease, zoals geretourneerd door marketplace_leases_list.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: String, maximaal 4096 tekens, geretourneerd door een eerdere aanroep van deze tool voor deze lease. Weglaten bij de eerste aanroep; ongewijzigd opnieuw verzenden samen met confirmationResponse.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: accept of decline. Alleen zinvol samen met een geldige confirmationToken. Weglaten bij de eerste aanroep.

Retourneert — na de eerste aanroep (niets geannuleerd):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ...",
"note": "Er is nog niets gewijzigd. Toon de bevestiging aan de gebruiker en roep, zodra die akkoord gaat, marketplace_lease_cancel opnieuw aan met deze confirmationToken en confirmationResponse=\"accept\", of met confirmationResponse=\"decline\" om te annuleren.",
"summary": "Annuleer de lease-to-own van leasedname.io. Je hebt USD 300.00 betaald en er staat nog USD 900.00 open. Reeds betaalde bedragen worden niet terugbetaald en het domein gaat terug naar de verkoper. Dit kan hier niet ongedaan worden gemaakt."
}

Na accept:

{
"status": "cancel_accepted",
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"note": "De annulering is geaccepteerd. Lees de lease met marketplace_lease_get om de status te volgen."
}

  • status: confirmation_required

    Betekenis: Er is nog niets gewijzigd; toon summary en roep opnieuw aan met het token.

  • status: cancelled

    Betekenis: Je hebt geweigerd; er is niets gewijzigd. { "status": "cancelled", "note": "Nothing was changed because the action was not confirmed." }

  • status: cancel_accepted

    Betekenis: De annulering is geaccepteerd. De lease kan een tijdje cancelling tonen voordat deze cancelled bereikt; volg deze met marketplace_lease_get.

marketplace_listings_search — Marketplace-vermeldingen zoeken

Toegang: Lezen.

Zoekt in de domeinen die andere mensen te koop hebben aangeboden op de Spaceship marketplace op één verplicht trefwoord, verfijnd op TLD, prijsbereik in hele USD-bedragen, naamlengte en aankoopoptie (Nu kopen, biedingen, lease-to-own). Om naar meerdere woorden te zoeken, roep je één keer per woord aan. Resultaten komen nieuwste eerst. Je eigen vermeldingen worden weggelaten. Elk resultaat bevat de Nu kopen-prijs, het minimumbod en de lease-to-own-voorwaarden wanneer de verkoper die heeft ingesteld, en de id van je eigen onderhandeling voor dat domein, als je die hebt.

Een zoekopdracht die niets oplevert, geeft { "items": [] } terug, geen fout. Een ontbrekend trefwoord, een trefwoord dat niet uit één woord van minstens 3 letters of cijfers bestaat, een bereik waarvan het minimum hoger is dan het maximum, een herhaalde TLD (hoofdletterongevoelig vergeleken), meer dan 10 TLD's, een prijs met decimalen, een prijs, lengte, limit of offset buiten het bereik in de onderstaande tabel, of een parameter die hieronder niet wordt vermeld, wordt geweigerd met application.request.badRequest.

  • Parameter: search

    Vereist: Ja

    Type & beperkingen: String, maximaal 253 tekens. Eén trefwoord om in de domeinnaam naar te zoeken: één enkel woord zonder spaties, komma's of puntkomma's, met minstens 3 letters of cijfers achter elkaar. Voor meerdere woorden roep je één keer per woord aan.

  • Parameter: tlds

    Vereist: Nee

    Type & beperkingen: Array van 1–10 verschillende TLD's zonder de punt, bijvoorbeeld ["com", "io"]. Letters, cijfers, koppeltekens en interne punten (co.uk).

  • Parameter: minPrice

    Vereist: Nee

    Type & beperkingen: Integer, 0–10000000. Laagste prijs in hele Amerikaanse dollars. Niet hoger dan maxPrice.

  • Parameter: maxPrice

    Vereist: Nee

    Type & beperkingen: Integer, 0–10000000. Hoogste prijs in hele Amerikaanse dollars.

  • Parameter: minLength

    Vereist: Nee

    Type & beperkingen: Integer, 1–63. Kortste naamlengte, geteld zonder de TLD. Niet hoger dan maxLength.

  • Parameter: maxLength

    Vereist: Nee

    Type & beperkingen: Integer, 1–63. Langste naamlengte, geteld zonder de TLD.

  • Parameter: buyNow

    Vereist: Nee

    Type & beperkingen: Boolean. true: alleen domeinen die je direct kunt kopen; false: alleen domeinen zonder Nu kopen.

  • Parameter: offers

    Vereist: Nee

    Type & beperkingen: Boolean. true: alleen domeinen die biedingen accepteren; false: alleen domeinen die dat niet doen.

  • Parameter: leaseToOwn

    Vereist: Nee

    Type & beperkingen: Boolean. true: alleen domeinen met lease-to-own; false: alleen domeinen zonder.

  • Parameter: limit

    Vereist: Nee

    Type & beperkingen: Integer, 1–50. Standaard 20.

  • Parameter: offset

    Vereist: Nee

    Type & beperkingen: Geheel getal, 0–1000. Standaard 0.

Retourneert — { items }, één pagina met overeenkomende vermeldingen. Het antwoord bevat geen totaal aantal: een pagina met minder vermeldingen dan limit is de laatste.

{
"items": [
{
"domain": "BestShop.io",
"tld": "io",
"buyNow": true,
"buyNowPrice": { "amount": "900.00", "currency": "USD" },
"minOffer": { "amount": "200.00", "currency": "USD" },
"leaseToOwn": {
"total": { "amount": "1200.00", "currency": "USD" },
"downPayment": { "amount": "120.00", "currency": "USD" },
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12
},
"negotiationId": null
}
]
}

  • Veld: domain

    Betekenis: Het domein zoals de verkoper het weergeeft (het kan hoofdletters bevatten).

  • Veld: tld

    Betekenis: De TLD van het domein, zonder de punt.

  • Veld: buyNow / buyNowPrice

    Betekenis: Of het direct gekocht kan worden, en de Buy Now-prijs of null.

  • Veld: minOffer

    Betekenis: Het laagste bod dat de verkoper accepteert, of null.

  • Veld: leaseToOwn

    Betekenis: { total, downPayment, installment, installments } wanneer de verkoper lease-to-own aanbiedt (downPayment kan null zijn); anders null.

  • Veld: negotiationId

    Betekenis: De id van je eigen open onderhandeling voor dit domein, of null.

Toegang: Schrijven.

Geeft je als koper een link om op Spaceship te betalen voor een marktplaatsdomein. Het uitgeven van een link brengt niets in rekening: je opent deze, bekijkt de kosten en het eindbedrag op de Spaceship-betaalpagina en betaalt daar. De link weerspiegelt de vermelding, onderhandeling of deal zoals die is op het moment dat deze wordt geopend, en is voor je eigen Spaceship-account. Opnieuw aanroepen is veilig en geeft een nieuwe link.

Geef precies één van domain, negotiationId of dealId door:

  • domain: een domein dat een andere verkoper met Buy Now aanbiedt. De link is voor de Buy Now-prijs.

  • negotiationId: een onderhandeling waarbij jij de koper bent en een overeenkomst is bereikt. De link is voor het overeengekomen bedrag, of voor de overeengekomen Lease-to-Own-voorwaarden wanneer de overeenkomst een lease is.

  • dealId: een SafePay-deal waarbij jij de koper bent en waarvan de status active is, de enige status waarin de koper kan betalen. Het antwoord is de eigen betaallink van de deal. Een deal in awaiting_payment (de koper koos bankoverschrijving of BTCPay en Spaceship-support heeft het geld nog niet bevestigd) kan nog niet via de link worden betaald.

Geef bij domain of negotiationId ook contactId door: een van je opgeslagen contacten, uit contacts_list, of een nieuw contact uit contacts_save. Dit wordt de registrant-, admin-, tech- en factureringscontactpersoon van het domein wanneer het domein naar je account wordt verplaatst. Een dealId gebruikt geen contactId, omdat de eigen link van de deal wordt teruggegeven; de betaalpagina daarvan vraagt om contacten en kan niet worden voltooid als er geen contacten in je account zijn opgeslagen.

Geen, of meer dan één, van de drie wordt afgewezen met application.request.badRequest ("Geef precies één van domain, negotiationId of dealId door."), en een domain dat geen domeinnaam is met business.invalidArgument ("Het domein moet een domeinnaam zijn zoals "example.com"."). Een ontbrekende contactId bij domain of negotiationId, of een contactId bij dealId, wordt afgewezen met application.request.badRequest voordat er iets wordt opgezocht ("contactId is vereist bij domain of negotiationId." of "contactId wordt niet gebruikt bij dealId."). Een contactId die niet een van je contacten is, geeft business.notFound als antwoord ("Contact niet gevonden in dit account."), hetzelfde als contacts_get, en er wordt geen link aangemaakt.

  • Parameter: domain

    Vereist: Voorwaardelijk

    Type & beperkingen: Tekenreeks, 3–253 tekens. Een domein dat te koop staat met Buy Now, Unicode of ASCII. Precies één van de drie.

  • Parameter: negotiationId

    Vereist: Voorwaardelijk

    Type & beperkingen: ID van een onderhandeling, zoals geretourneerd door marketplace_negotiations_list. Precies één van de drie.

  • Parameter: dealId

    Vereist: Voorwaardelijk

    Type & beperkingen: UUID van een SafePay-deal, zoals geretourneerd door marketplace_safepay_deals_list. Precies één van de drie.

  • Parameter: contactId

    Vereist: Voorwaardelijk

    Type & beperkingen: Contact-ID (27–32 alfanumerieke tekens), zoals geretourneerd door contacts_list of contacts_save. Vereist bij domain of negotiationId; niet toegestaan bij dealId.

Retourneert — link_ready met de link, of nothing_to_buy:

{
"status": "link_ready",
"case": "buy_now",
"url": "https://www.spaceship.com/...",
"domain": "bestshop.io",
"buyNowPrice": { "amount": "900.00", "currency": "USD" },
"note": "Het uitgeven van deze link bracht niets in rekening. Open deze om op Spaceship te betalen: de betaalpagina toont de kosten en het eindbedrag. De link weerspiegelt de vermelding, onderhandeling of deal zoals die is op het moment dat deze wordt geopend, en is voor je eigen Spaceship-account. Het contact dat als contactId is opgegeven, wordt de registrant-, admin-, tech- en factureringscontactpersoon van het domein wanneer het domein naar je account wordt verplaatst."
}

  • Veld: case

    Betekenis: buy_now, agreement, agreement_lease_to_own of safepay.

  • Veld: url

    Betekenis: De te openen betaallink.

  • Veld: domain

    Betekenis: Het domein, wanneer dit bekend is.

  • Veld: buyNowPrice

    Betekenis: Bij buy_now: de Buy Now-prijs van de vermelding.

  • Veld: acceptedOfferAmount

    Betekenis: Bij agreement: het bedrag dat is overeengekomen.

  • Veld: leaseToOwn

    Betekenis: Bij agreement_lease_to_own: { total, downPayment, finalPayment, installment, installments } zoals overeengekomen (downPayment en finalPayment kunnen null zijn).

  • Veld: amountBuyerPays

    Betekenis: Bij safepay: wat volgens de deal door de koper wordt betaald.

Alleen de prijs die in de vermelding, onderhandeling of deal staat, wordt getoond; het antwoord voegt nooit kosten toe of berekent een totaal, en een prijs die niet bekend is, wordt weggelaten.

{
"status": "nothing_to_buy",
"reason": "no_agreement",
"note": "De onderhandeling heeft nog geen overeenkomst, dus er is nog niets om voor te betalen."
}

  • reden: buy_now_off

    Betekenis: Het domein staat vermeld, maar Buy Now staat uit. Je kunt in plaats daarvan een bod doen.

  • reden: lease_to_own_only

    Betekenis: Het domein wordt alleen aangeboden met Lease-to-Own, wat hier niet via een betaallink kan worden gekocht. Je kunt in plaats daarvan een bod doen.

  • reden: no_agreement

    Betekenis: De onderhandeling heeft nog geen overeenkomst.

  • reden: not_the_buyer

    Betekenis: Jij bent de verkoper; alleen de koper betaalt.

  • reden: deal_not_payable

    Betekenis: De SafePay-deal staat niet op active, dus deze kan nu niet via de link worden betaald.

reason is een gesloten lijst die kan groeien: behandel een waarde die je niet kent als "op dit moment niets om voor te betalen".

Een onderhandeling of deal waarbij je geen partij bent, geeft business.notFound als antwoord, precies zoals een onderhandeling of deal die niet bestaat, en een domein dat niet te koop staat, geeft business.notFound met "Het domein staat niet te koop.". Wanneer de link niet kan worden voorbereid, mislukt de aanroep met infrastructure.serviceUnavailable ("De betaallink kon niet worden voorbereid. Er is niets in rekening gebracht."); het aanmaken van een link brengt niets in rekening, dus het herhalen van de aanroep is veilig (zie Schrijfbewerkingen opnieuw proberen).

Marketplace: bulkbewerkingen

Bewerkingen op veel vermeldingen of onderhandelingen tegelijk. Ze worden uitgevoerd na de aanroep: het antwoord is status: "working" met een bewerkingshandle om te volgen met async_operation_get. Er wordt per account maar één bulkbewerking tegelijk uitgevoerd.

marketplace_listings_import — Marketplace-vermeldingen importeren

Toegang: Gevoelig schrijven — zet tot 5000 domeinen tegelijk te koop.

Zet in één bewerking tot 5000 domeinen te koop op de Spaceship-marktplaats, ongeacht of ze in je Spaceship-account staan of elders zijn geregistreerd, elk met een optionele Buy Now-prijs, minimum bod en For Sale-pagina. Een elders geregistreerd domein wordt vermeld zodra het eigendom is geverifieerd. Een domein dat wordt geïmporteerd met een Buy Now-prijs krijgt ook de voor het account opgeslagen Lease-to-Own-voorinstellingen, als die er zijn, net zoals een import in SellerHub doet. Wanneer ten minste één domein uit de aanroep een Buy Now-prijs heeft, vermeldt de note van het antwoord dat, tenzij er geen enkel domein is vermeld. De import wordt uitgevoerd na de aanroep: het antwoord is status: "working" met een bulk:-bewerkingshandle in operation.operationId en checkWith, en checkAfterSeconds geeft aan wanneer je moet kijken. Geef de handle door aan async_operation_get, dat rapporteert hoeveel domeinen van het totaal zijn verwerkt en, voor elk domein dat niet is vermeld, een reden zoals "Het domein staat al vermeld." of "Het domein staat niet in dit account.". Herhaal een aanroep die working heeft geantwoord niet: de import is al gestart, en herhalen versnelt deze niet.

Er wordt per account maar één bulkbewerking tegelijk uitgevoerd. Terwijl er één loopt, is het antwoord status: "already_running" met een note, wordt er niets nieuws gestart, en dat is geen fout: wacht tot de lopende bewerking is voltooid en roep dan opnieuw aan. Invoer die de onderstaande regels schendt (bijvoorbeeld hetzelfde domein twee keer, of forSalePage zonder prijs) wordt afgewezen met application.request.badRequest voordat er iets start.

  • Parameter: domains

    Vereist: Ja

    Type & beperkingen: 1–5000 te vermelden domeinen, elk maximaal één keer.

  • Parameter: domains.name

    Vereist: Ja

    Type & beperkingen: Volledig gekwalificeerde domeinnaam, 3–253 tekens, bijvoorbeeld example.com. Vergeleken zonder hoofdlettergevoeligheid.

  • Parameter: domains.buyNowPrice

    Vereist: Nee

    Type & beperkingen: Buy Now-prijs in hele Amerikaanse dollars, 1–10,000,000. Schakelt Buy Now in.

  • Parameter: domains.minOfferPrice

    Vereist: Nee

    Type & beperkingen: Minimumbod in hele Amerikaanse dollars, 1–10,000,000. Schakelt biedingen in.

  • Parameter: domains.forSalePage

    Vereist: Voorwaardelijk

    Type & beperkingen: Booleaans; of de For Sale-pagina is ingeschakeld. Alleen toegestaan samen met buyNowPrice of minOfferPrice.

Retourneert — het gedeelde antwoord van een bewerking die na de aanroep wordt uitgevoerd:

  • Veld: status

    Betekenis: working zodra de import is gestart; already_running wanneer er al een andere bulkbewerking van het account loopt (dan worden alleen status en note geretourneerd).

  • Veld: operation

    Betekenis: De bewerking zoals deze het laatst is gelezen, ter informatie: operationId (de bulk:-handle), status (pending, success of failed, dezelfde waarden die async_operation_get voor deze handle retourneert), type (marketplace_listingsImport; marketplace_listingsBulkUpdate en marketplace_negotiationsBulkCancel voor de andere twee bulktools), details (voortgang), createdAt en modifiedAt.

  • Veld: checkWith

    Betekenis: { "tool": "async_operation_get", "arguments": { "operationId": "bulk:…" } } — de aanroep die je moet doen om de import te volgen.

  • Veld: checkAfterSeconds

    Betekenis: Hoe lang je moet wachten voordat je controleert, bijvoorbeeld 10.

  • Veld: note

    Betekenis: Wat er is gebeurd en wat je daarna moet doen; toon dit aan de gebruiker.

{
"status": "already_running",
"note": "Er loopt al een bewerking van dit type voor dit account, dus er is geen nieuwe gestart. Wacht tot deze is voltooid en probeer het daarna opnieuw."
}

marketplace_listings_bulk_update — Marketplace-vermeldingen in bulk bijwerken

Toegang: Gevoelig schrijven — wijzigt de prijzen die kopers betalen op tot 5000 vermeldingen tegelijk.

Wijzigt één groep instellingen op veel marktplaatsvermeldingen in één bewerking: prices (Buy Now en minimumbod, met een optionele Quality Offer-aanbetaling), pageSettings (For Sale-pagina, Contact Owner-formulier en de link naar je verkopersportfolio), of leaseToOwn (uitschakelen, of de voor je account opgeslagen lease-to-own-voorinstellingen toepassen). Stuur precies één van de drie groepen en selecteer de vermeldingen met precies één van listingIds (tot 5000) of filter. Een filter moet ten minste één criterium bevatten; om elke vermelding te wijzigen, stel je alleen filter.allListings in op true.

De update wordt uitgevoerd na de aanroep: het antwoord is status: "working" met een bulk:-bewerkingshandle om door te geven aan async_operation_get, dat rapporteert hoeveel vermeldingen van het totaal zijn verwerkt en, voor elke vermelding die niet is gewijzigd, een reden zoals "Het domein heeft geen Buy Now-prijs." of "Er zijn geen lease-to-own-voorinstellingen voor het account opgeslagen.". Herhaal een aanroep die working heeft geantwoord niet. Er wordt per account maar één bulkbewerking tegelijk uitgevoerd; terwijl er één loopt, is het antwoord status: "already_running" met een note, wordt er niets nieuws gestart, en dat is geen fout. Invoer die de onderstaande regels schendt, wordt afgewezen met application.request.badRequest voordat er iets start.

  • Parameter: listingIds

    Vereist: Voorwaardelijk

    Type & beperkingen: 1–5000 vermelding-ID's (UUID's), elk maximaal één keer: de listingId van marketplace_listings_list of marketplace_listing_get. Stuur listingIds of filter, niet beide.

  • Parameter: filter

    Vereist: Voorwaardelijk

    Type & beperkingen: Criteria die de te wijzigen vermeldingen selecteren. Stuur listingIds of filter, niet beide. Vereist ten minste één criterium, of alleen allListings.

  • Parameter: filter.allListings

    Vereist: Nee

    Type & beperkingen: true om elke vermelding van het account te wijzigen. Niet gecombineerd met andere criteria.

  • Parameter: filter.tlds

    Vereist: Nee

    Type & beperkingen: 1–50 extensies zonder de voorloop-punt, bijvoorbeeld ["com", "io"].

  • Parameter: filter.nameContains

    Vereist: Nee

    Type & beperkingen: Alleen vermeldingen waarvan de domeinnaam deze tekst bevat, 1–63 tekens.

  • Parameter: filter.buyNowEnabled

    Vereist: Nee

    Type & beperkingen: Booleaans; alleen vermeldingen met Buy Now aan (true) of uit (false).

  • Parameter: filter.minOfferEnabled

    Vereist: Nee

    Type & beperkingen: Booleaans; alleen vermeldingen die biedingen accepteren (true) of niet (false).

  • Parameter: filter.forSalePageEnabled

    Vereist: Nee

    Type & beperkingen: Booleaans; alleen vermeldingen met de For Sale-pagina aan (true) of uit (false). Mag in dezelfde aanroep niet gelijk zijn aan pageSettings.forSalePageEnabled.

  • Parameter: prices

    Vereist: Voorwaardelijk

    Type & beperkingen: Prijsinstellingen. Stuur precies één van prices, pageSettings en leaseToOwn. Vereist buyNowEnabled, minOfferEnabled of beide, en de twee mogen niet allebei false zijn.

  • Parameter: prices.buyNowEnabled

    Vereist: Nee

    Type & beperkingen: Booleaans; schakelt Buy Now in of uit.

  • Parameter: prices.buyNowPrice

    Vereist: Voorwaardelijk

    Type & beperkingen: Hele Amerikaanse dollars, 1–10,000,000. Vereist wanneer buyNowEnabledtrue is, en alleen dan toegestaan.

  • Parameter: prices.minOfferEnabled

    Vereist: Nee

    Type & beperkingen: Boolean; schakelt aanbiedingen in of uit.

  • Parameter: prices.minOfferPrice

    Vereist: Voorwaardelijk

    Type & beperkingen: Hele Amerikaanse dollars, 1–10,000,000. Vereist wanneer minOfferEnabledtrue is, en alleen dan toegestaan.

  • Parameter: prices.qualityOffer

    Vereist: Nee

    Type & beperkingen: Quality Offer-instelling toegepast met de prijzen.

  • Parameter: prices.qualityOffer.requirement

    Vereist: Ja, binnen qualityOffer

    Type & beperkingen: Of kopers een aanbetaling doen bij een bod: disabled, optional of mandatory.

  • Parameter: prices.qualityOffer.depositAmount

    Vereist: Voorwaardelijk

    Type & beperkingen: Aanbetaling in hele Amerikaanse dollars, 10–50. Vereist wanneer requirementoptional of mandatory is; niet toegestaan met disabled.

  • Parameter: pageSettings

    Vereist: Voorwaardelijk

    Type & beperkingen: Instellingen voor de Te koop-pagina. Verstuur precies één van prices, pageSettings en leaseToOwn. Er moet minstens één veld worden gewijzigd.

  • Parameter: pageSettings.forSalePageEnabled

    Vereist: Nee

    Type & beperkingen: Boolean; schakelt de Te koop-pagina in of uit.

  • Parameter: pageSettings.contactOwnerEnabled

    Vereist: Nee

    Type & beperkingen: Boolean; schakelt het formulier Contact opnemen met eigenaar op de Te koop-pagina in of uit.

  • Parameter: pageSettings.showSellerPortfolioLink

    Vereist: Nee

    Type & beperkingen: Boolean; of de Te koop-pagina linkt naar je verkopersportfoliopagina.

  • Parameter: leaseToOwn

    Vereist: Voorwaardelijk

    Type & beperkingen: Wijziging voor lease-to-own. Verstuur precies één van prices, pageSettings en leaseToOwn.

  • Parameter: leaseToOwn.action

    Vereist: Ja, binnen leaseToOwn

    Type & beperkingen: disable schakelt lease-to-own uit; apply_saved_presets past de lease-to-own-voorinstellingen toe die voor je account zijn opgeslagen.

Retourneert — hetzelfde gedeelde antwoord als marketplace_listings_import: status (working of already_running), operation met de bulk:-handle, checkWith, checkAfterSeconds en note. Een working-antwoord ziet er zo uit (het operation-object, gegeven ter informatie, is hier weggelaten):

{
"status": "working",
"checkWith": {
"tool": "async_operation_get",
"arguments": { "operationId": "bulk:5b8e2c41-7d3a-4f19-9c06-2e7a1d4b8f53" }
},
"checkAfterSeconds": 10,
"note": "The update is still running; operation.details holds the progress. The operation is not complete yet. Check again with async_operation_get in about 10 seconds. Do not call marketplace_listings_bulk_update again for this request; the operation has already started."
}

marketplace_negotiations_bulk_cancel — Marketplace-onderhandelingen in bulk annuleren

Toegang: Gevoelige schrijfactie — annuleert veel onderhandelingen tegelijk.

Annuleert veel onderhandelingen over je aanbiedingen in één bewerking, geselecteerd met precies één van negotiationIds (tot 5000) of filter. Een filter selecteert alleen open onderhandelingen en moet minstens één criterium opgeven; om elke open onderhandeling over je aanbiedingen te annuleren, stel je filter.allNegotiations alleen in op true. Een geannuleerde onderhandeling wordt opgeschort, niet verwijderd: elke onderhandeling kan later afzonderlijk worden hervat.

Wanneer de selectie geen open onderhandeling oplevert, is het antwoord het normale resultaat { "status": "nothing_to_cancel", "matchedCount": 0, "note": "No open negotiation matches the selection, so nothing was cancelled and no confirmation is needed." }: er wordt niets geannuleerd en er hoeft niets te worden bevestigd.

Bevestiging in twee stappen. Roep eerst aan zonder confirmationToken: er wordt niets geannuleerd, en het antwoord is status: "confirmation_required" met matchedCount, het aantal onderhandelingen dat de selectie nu oplevert, en een confirmationToken. Laat de gebruiker zien wat er geannuleerd zal worden en roep daarna opnieuw aan met dezelfde argumenten, dat confirmationToken en confirmationResponse: "accept" om door te gaan, of confirmationResponse: "decline" om te stoppen; bij een weigering is het antwoord status: "cancelled" en verandert er niets. Het token is gebonden aan precies deze argumenten en aan het aantal treffers, en verloopt na korte tijd: een verouderd of niet langer passend token krijgt een nieuw confirmation_required met een nieuw token, nooit een fout.

De geaccepteerde aanroep start de annulering, die na de aanroep wordt uitgevoerd: het antwoord is status: "working" met een bulk:-bewerkinghandle om door te geven aan async_operation_get, dat rapporteert hoeveel onderhandelingen zijn afgehandeld van het totaal en, voor elke onderhandeling die niet is geannuleerd, een reden zoals "The negotiation has an agreed sale." of "The negotiation is already cancelled.". Herhaal geen aanroep die working als antwoord gaf. Er kan per account maar één bulkbewerking tegelijk worden uitgevoerd; terwijl er één loopt, is het antwoord status: "already_running" met een note en wordt er niets nieuws gestart.

  • Parameter: negotiationIds

    Vereist: Voorwaardelijk

    Type & beperkingen: 1–5000 onderhandelings-ID's (UUID's), elk maximaal één keer. Verstuur óf negotiationIds óf filter, niet beide.

  • Parameter: filter

    Vereist: Voorwaardelijk

    Type & beperkingen: Criteria die de open onderhandelingen over je aanbiedingen selecteren. Verstuur óf negotiationIds óf filter, niet beide. Vereist minstens één criterium, of alleen allNegotiations.

  • Parameter: filter.allNegotiations

    Vereist: Nee

    Type & beperkingen: true om elke open onderhandeling over je aanbiedingen te annuleren. Niet te combineren met andere criteria.

  • Parameter: filter.domainNameContains

    Vereist: Nee

    Type & beperkingen: Alleen onderhandelingen waarvan de domeinnaam deze tekst bevat, 1–63 tekens.

  • Parameter: filter.qualityOfferOnly

    Vereist: Nee

    Type & beperkingen: true voor alleen onderhandelingen met een Quality Offer-aanbetaling.

  • Parameter: confirmationToken

    Vereist: Nee

    Type & beperkingen: Token uit het vorige confirmation_required-antwoord voor precies deze argumenten, tot 4096 tekens. Weglaten bij de eerste aanroep.

  • Parameter: confirmationResponse

    Vereist: Voorwaardelijk

    Type & beperkingen: accept of decline. Alleen samen met confirmationToken.

Retourneert

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ0IjoibWFya2V0cGxhY2VfbmVnb3RpYXRpb25zX2J1bGtfY2FuY2VsIn0.Qm9yZGVy",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_negotiations_bulk_cancel again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"matchedCount": 12
}

  • status: confirmation_required

    Betekenis: Er is niets geannuleerd. Bevat matchedCount en een confirmationToken voor de bevestigende aanroep.

  • status: cancelled

    Betekenis: Het verzoek is afgewezen; er is niets gewijzigd. Bevat matchedCount.

  • status: working

    Betekenis: De annulering is gestart. Bevat operation met de bulk:-handle, checkWith, checkAfterSeconds en note, zoals bij marketplace_listings_bulk_update.

  • status: already_running

    Betekenis: Er loopt al een andere bulkbewerking voor het account; er is niets nieuws gestart. Wacht tot die is voltooid en probeer het daarna opnieuw.

Marketplace: exports

Download de aanbiedingen of verkopen van het account als CSV-bestand. Het bestand wordt na de aanroep voorbereid: het antwoord is status: "working" met een event:-bewerkinghandle om te volgen met async_operation_get, en de voltooide bewerking bevat een link naar het bestand. Per account kan er van elk type maar één export tegelijk lopen.

marketplace_listings_export — Mijn Marketplace-aanbiedingen exporteren

Toegang: Lezen.

Start een CSV-export van de huidige aanbiedingen van je account op de Spaceship-marketplace, zoals het tabblad SellerHub Domains ze toont, met hun prijzen en instellingen. status en tld beperken dit op dezelfde manier als ze marketplace_listings_list beperken, bijvoorbeeld tot alleen .com-aanbiedingen.

  • Parameter: status

    Vereist: Nee

    Type & beperkingen: 1–9 verschillende aanbiedingsstatussen, zoals in marketplace_listings_list. Weglaten voor de huidige aanbiedingen.

  • Parameter: tld

    Vereist: Nee

    Type & beperkingen: 1–20 verschillende extensies zonder de voorloop-punt, bijvoorbeeld ["com"].

Het antwoord is status: "working" met een bewerkingshandle in operation.operationId, ook gegeven als checkWith. checkAfterSeconds geeft aan wanneer je moet kijken.

Geef de handle door aan async_operation_get. Wanneer de export slaagt, linkt details.downloadUrl naar het CSV-bestand tot details.downloadUrlExpiresAt.

Herhaal de aanroep niet terwijl de export nog bezig is: deze is al gestart, en herhalen maakt het niet sneller.

Terwijl er een export van aanbiedingen voor het account loopt, is het antwoord status: "already_running" met een note, wordt er niets nieuws gestart, en dat is geen fout: wacht tot de lopende export is voltooid en roep daarna opnieuw aan. Dat antwoord bevat geen handle, omdat de lopende export niet benoemd kan worden.

Retourneert — het gedeelde antwoord van een bewerking die na de aanroep wordt uitgevoerd:

  • Veld: status

    Betekenis: working zodra de export is gestart; already_running terwijl er een andere export van aanbiedingen voor het account loopt (dan worden alleen status en note geretourneerd).

  • Veld: export

    Betekenis: listings.

  • Veld: operation

    Betekenis: De bewerking zoals die het laatst is gelezen, ter informatie: operationId (de event:-handle), status (pending, success of failed, dezelfde waarden die async_operation_get voor deze handle retourneert), type (marketplace_listingsExport), details, createdAt en modifiedAt.

  • Veld: checkWith

    Betekenis: { "tool": "async_operation_get", "arguments": { "operationId": "event:…" } } — de aanroep die je moet doen om de export te volgen.

  • Veld: checkAfterSeconds

    Betekenis: Hoe lang je moet wachten voordat je controleert, bijvoorbeeld 10.

  • Veld: note

    Betekenis: Wat er is gebeurd en wat je nu moet doen; toon dit aan de gebruiker.

Een working-antwoord ziet er zo uit (het operation-object, gegeven ter informatie, is hier weggelaten):

{
"status": "working",
"checkWith": {
"tool": "async_operation_get",
"arguments": { "operationId": "event:0b6cf50e-95a3-4c4b-8f43-2d84e537f3c5" }
},
"checkAfterSeconds": 10,
"export": "listings",
"note": "The export file is being prepared. The operation is not complete yet. Check again with async_operation_get in about 10 seconds. Do not call marketplace_listings_export again for this request; the operation has already started."
}

marketplace_sales_export — Mijn Marketplace-verkopen exporteren

Toegang: Lezen.

Start een CSV-export van de domeinen die je account op de Spaceship-marketplace heeft verkocht tussen soldFrom en soldTo, beide UTC-datums en beide inbegrepen. Dit wordt na de aanroep uitgevoerd precies zoals marketplace_listings_export: het antwoord is status: "working" met een event:-handle om door te geven aan async_operation_get, waarvan het success-antwoord details.downloadUrl en details.downloadUrlExpiresAt bevat. Herhaal geen aanroep die working als antwoord gaf. Terwijl er een export van verkopen voor het account loopt, is het antwoord status: "already_running" met een note en wordt er niets nieuws gestart. Een datum die geen echte kalenderdatum is, of een soldFrom na soldTo, wordt geweigerd met application.request.badRequest voordat er iets start.

  • Parameter: soldFrom

    Vereist: Ja

    Type & beperkingen: Eerste verkoopdatum om op te nemen, YYYY-MM-DD (UTC). Mag niet na soldTo liggen.

  • Parameter: soldTo

    Vereist: Ja

    Type & beperkingen: Laatste verkoopdatum om op te nemen, YYYY-MM-DD (UTC).

Retourneert — hetzelfde gedeelde antwoord als marketplace_listings_export, met export ingesteld op sales en het bewerkingstype typemarketplace_salesExport.

Asynchrone bewerkingen

async_operation_get — Status van asynchrone bewerking ophalen

Toegang: Lezen.

Controleert een langlopende bewerking op je account aan de hand van de operationId. Roep dit herhaaldelijk aan totdat statussuccess of failed is. Voor een domeinregistratie retourneert het ook het aankoopbewijs (zie hieronder).

  • Parameter: operationId

    Vereist: Ja

    Type & beperkingen: Alfanumerieke tekenreeks, max. 36 tekens, geretourneerd door de tool die de bewerking heeft gestart. Het kan ook een handle zijn met een voorvoegsel async:, bulk: of event:, precies zoals een tool die heeft geretourneerd.

Retourneert

  • Veld: operationId

    Betekenis: De opgevraagde bewerking.

  • Veld: status

    Betekenis: pending, success of failed.

  • Veld: type

    Betekenis: Type bewerking, of null.

  • Veld: details

    Betekenis: Extra details over de bewerking, of null.

  • Veld: createdAt / modifiedAt

    Betekenis: Wanneer de bewerking is aangemaakt / voor het laatst is bijgewerkt (modifiedAt kan null zijn).

  • Veld: orderId

    Betekenis: Alleen domeinregistraties die zijn beëindigd (success of failed). De bestelling waartoe de aankoop behoort, aanwezig wanneer de bewerking de bestelling benoemt. Deze wordt achtergehouden als die bestelling voor dit domein niet bij je account hoort.

  • Veld: nextRenewal

    Betekenis: Alleen succesvolle domeinregistraties. Een object met de date (YYYY-MM-DD) waarop het geregistreerde domein bij de registry verloopt, en de verlengingsprice voor één jaar (bedrag en valuta). De prijs wordt weggelaten wanneer die niet kan worden bepaald, en het hele veld wordt weggelaten wanneer het registry-record niet kan worden gelezen. De datum komt van de registry, dus het is geen schatting.

  • Veld: refusalReason

    Betekenis: Alleen mislukte domeinregistraties, wanneer de bestelling laat zien dat de betaling is geweigerd. payment_declined (corrigeer of vervang de betaalmethode en start de aankoop daarna opnieuw) of cardholder_confirmation_required (voltooi de aankoop op de website met een betaalmethode die de kaarthouder kan bevestigen). Er kunnen meer waarden worden toegevoegd, dus behandel een onbekende waarde als een algemene betalingsweigering. Ontbreekt bij elke andere mislukking, en telkens wanneer de bestelling niet kan worden gelezen, niet bij uw account voor dit domein hoort, of te lang duurt om te lezen.

  • Veld: paymentMethods

    Betekenis: Alleen naast refusalReason, en alleen wanneer ze konden worden gelezen: de opgeslagen betaalmethoden van het account, elk alleen { id, label }. Anders dan een payment_unavailable resultaat bevat dit geen type, volgorde, saldo of vervalmarkering.

Ontvangstbewijs van domeinregistratie. Wanneer een domeinregistratiebewerking eindigt, is de antwoordtekst een aankoopbewijs — toon dit ongewijzigd aan de gebruiker. Alleen een registratiebewerking die success of failed bereikt, krijgt er een; elke andere bewerking, en een registratie die nog pending is, wordt exact zoals voorheen teruggegeven.

Een success is het bevestigde ontvangstbewijs:

Uw aankoop is bevestigd. example.com is geregistreerd.
Bestel-ID: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Domein: example.com
Looptijd: 1 jaar
In rekening gebracht: 9.08 USD
Betaalmethode: Visa ···1234
Volgende verlenging: Wordt verlengd op 2027-10-13 voor 10.98 USD
Hulp nodig? Neem contact op met support: https://www.spaceship.com/about/contact-us/
Terugbetalingsbeleid: https://www.spaceship.com/legal/refund-policy/

{
"operationId": "2c9a4e7d1b3f48a6b05d9e7c1f2a8b34",
"status": "success",
"type": "domains_Register",
"details": { "name": "example.com", "orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16" },
"createdAt": "2026-10-13T09:41:07Z",
"modifiedAt": "2026-10-13T09:41:19Z",
"orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16",
"nextRenewal": { "date": "2027-10-13", "price": { "amount": 10.98, "currency": "USD" } }
}

Een failed registratie wordt eerlijk vermeld — het domein is niet geregistreerd — en bevat geen bedrag, betaalmethode of verlenging:

Deze aankoop kon niet worden voltooid en het domein is niet geregistreerd.
Als u een afschrijving voor deze aankoop ziet, neem dan contact op met support.
Bestel-ID: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Domein: example.com
Hulp nodig? Neem contact op met support: https://www.spaceship.com/about/contact-us/
Terugbetalingsbeleid: https://www.spaceship.com/legal/refund-policy/

Wanneer de bestelling laat zien dat de betaling is geweigerd, voegt het mislukte ontvangstbewijs één regel met aanwijzingen toe na de kop, en voegt het resultaat refusalReason en, wanneer ze konden worden gelezen, de paymentMethods van het account toe:

Deze aankoop kon niet worden voltooid en het domein is niet geregistreerd.
Als u een afschrijving voor deze aankoop ziet, neem dan contact op met support.
De betaling is geweigerd. Corrigeer of vervang de betaalmethode en start de aankoop daarna opnieuw.
Bestel-ID: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Domein: example.com
Hulp nodig? Neem contact op met support: https://www.spaceship.com/about/contact-us/
Terugbetalingsbeleid: https://www.spaceship.com/legal/refund-policy/

{
"operationId": "2c9a4e7d1b3f48a6b05d9e7c1f2a8b34",
"status": "failed",
"type": "domains_Register",
"details": { "name": "example.com", "orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16" },
"createdAt": "2026-10-13T09:41:07Z",
"modifiedAt": "2026-10-13T09:41:19Z",
"orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16",
"refusalReason": "payment_declined",
"paymentMethods": [
{ "id": "3f1c2b7e-8d4a-4f6b-9c0e-1a2b3c4d5e6f", "label": "Visa ···1234" }
]
}

Een betaling die bevestiging van de kaarthouder nodig heeft, luidt "De betaling moet door de kaarthouder worden bevestigd, wat hier niet kan worden gedaan. Voltooi de aankoop op de website met een betaalmethode die u kunt bevestigen." met refusalReasoncardholder_confirmation_required.

Opmerkingen bij het ontvangstbewijs:

  • Het in rekening gebrachte bedrag, de betaalmethode en de looptijd komen uit de bestelling, en de verlengingsdatum komt van het geregistreerde domein. Als een bron niet beschikbaar of traag is, worden de regels die daarvan afhangen weggelaten en slaagt de aanroep toch — een waarde die niet kan worden vastgesteld, wordt nooit geraden. Wanneer de bewerking geen bestelling noemt, heeft het ontvangstbewijs geen bestel-ID, bedrag of betaalmethode, en wordt de looptijd afgeleid uit de registratie- en vervaldatums wanneer die dat toelaten.

  • De verlengingsregel luidt "Wordt verlengd op <date> voor <price>" wanneer automatische verlenging voor het domein is ingeschakeld en "Verloopt op <date>; verlengingsprijs <price>" wanneer die is uitgeschakeld. De prijs is de verlengingsprijs voor één jaar.

  • De betaalmethode luidt Visa ···1234 (drie middelste punten) of Account funds; een fondssaldo wordt nooit weergegeven.

  • Bij een failed resultaat krijgt structuredContentorderId, wanneer bekend en niet achtergehouden, en nooit nextRenewal. refusalReason en paymentMethods worden alleen toegevoegd wanneer de bestelling die de bewerking noemt bij uw account voor dit domein hoort en het itemrecord een geweigerde betaling vastlegt; elke andere mislukking, een bestelling die niet op tijd kan worden gelezen, of een bestelling die van iemand anders is, behoudt het gewone mislukte ontvangstbewijs. De reden wordt gelezen uit de eigen foutcode van de bestelling en is nooit de tekst van de betalingsprovider.

Bulk marketplace-bewerkingen. Een bulk: handle, teruggegeven door de bulktools van de marketplace (zie Marketplace: bulk operations), antwoordt met pending terwijl de bewerking loopt, met voortgang in details: done (items voltooid zonder mislukking) van total. Poll deze niet vaker dan de checkAfterSeconds die de starttool gaf. Een bewerking die langer duurt dan gebruikelijk blijft pending totdat deze echt eindigt; ze wordt nooit voortijdig als voltooid of mislukt gemeld.

Wanneer deze eindigt, is statussuccess als ten minste één listing of onderhandeling is geslaagd, zelfs wanneer andere zijn mislukt, en failed als geen enkele is geslaagd. Hoe dan ook, details.failed vermeldt elke listing of onderhandeling die niet is geslaagd, als { "item": "<domain name>", "reason": "<one sentence>" }, bijvoorbeeld { "item": "example.com", "reason": "The domain is not in this account." }. details.failedTotal is het aantal mislukte items en details.failedTruncated is true wanneer de lijst alleen de eerste daarvan toont. Los de oorzaak op die in een reden wordt genoemd voordat u voor die items een nieuwe bewerking start.

Het voltooide antwoord noemt de bewerking ook met de tool die deze heeft gestart in type (marketplace_listingsImport, marketplace_listingsBulkUpdate of marketplace_negotiationsBulkCancel) en bevat een note, die ook de antwoordtekst is: bij success vermeldt deze de aantallen die uit de bewerking zijn gelezen, bijvoorbeeld "De import is beëindigd: 2 van de 3 domeinen zijn vermeld, 1 is mislukt. operation.details.failed vermeldt elk domein dat niet is vermeld en waarom.", met een laatste zin die zegt hoeveel mislukkingen de lijst bevat wanneer deze is afgekapt; bij failed staat er dat geen enkel item is geslaagd. Wanneer de bewerking eindigt binnen de aanroep die haar heeft gestart, bevat het antwoord van die tool dezelfde status en type in zijn operation en opent zijn note met dezelfde samenvatting.

Een bulk: handle die bij een ander account hoort, antwoordt met business.notFound, precies zoals een handle die niet bestaat. Een voltooide bewerking blijft leesbaar, en een latere lezing geeft hetzelfde resultaat terug.

Marketplace-exporten. Een event: handle, teruggegeven door marketplace_listings_export en marketplace_sales_export, antwoordt met pending terwijl het bestand wordt voorbereid, met typemarketplace_listingsExport of marketplace_salesExport en details.export ingesteld op listings of sales. Wanneer het bestand gereed is, is het antwoord success, en details voegt downloadUrl toe, een link naar het CSV-bestand, en downloadUrlExpiresAt, wanneer die link niet meer werkt; om daarna een nieuwe link te krijgen, start u een nieuwe export. Een failed export bevat alleen details.export: het bestand kon niet worden voorbereid, en later kan een nieuwe export worden gestart. Een export die langer duurt dan gebruikelijk blijft pending totdat deze echt eindigt. Een event: handle die bij een ander account hoort, antwoordt met business.notFound, precies zoals een handle die niet bestaat, zodat een downloadlink alleen ooit wordt getoond aan het account dat de export heeft gestart.

Fouten

Wanneer een aanroep mislukt, retourneert de tool een fout met een code en een voor mensen leesbare detail die uitlegt wat er misging — bijvoorbeeld ongeldige invoer (een onjuist gevormde domeinnaam of contact-ID), een domein of contact dat niet bestaat, of een conflict met de huidige status. Als een tool niet beschikbaar is omdat de assistent er geen toegang toe heeft gekregen, verbind dan Spaceship MCP Connector opnieuw en keur de toegang goed waar deze om vraagt.

Een mislukte aanroep heeft altijd dezelfde vorm: isError is true, de tekstinhoud luidt <code>: <detail>, en structuredContent.error bevat code, detail en, wanneer afgewezen invoer meerdere problemen heeft, een lijst validationErrors. De vorm is stabiel; lees detail voor de oorzaak. Argumenten die niet overeenkomen met de parameters van een tool (een ontbrekend verplicht veld, een verkeerd type, een waarde buiten bereik) worden afgewezen voordat de tool iets doet met de code application.request.badRequest: detail noemt elk probleem, en validationErrors bevat één item per probleem met het pad van het argument in field (bijvoorbeeld items.0.domain) en de reden in message. Een aanroep boven de snelheidslimiet retourneert application.request.tooManyRequests, en een aanroep die niet is toegestaan door de scopes van het token retourneert application.forbidden. Een tool die niet onder de door u verleende toegang valt, wordt niet vermeld, en een aanroep ernaar wordt in plaats daarvan beantwoord als een onbekende tool (zie Access you grant).

Elke andere mislukking bevat een van zes codes die de situatie benoemen, zodat u kunt beslissen wat u daarna moet doen. De tekst detail is geschreven door de service, staat vast voor elke situatie en bevat nooit interne identificatoren of tekst van een verbonden systeem:

  • Code: business.notFound

    Betekenis: Het domein, contact of record bevindt zich niet in dit account, of de extensie heeft geen prijsinformatie.

    Vaste detailteksten: "Dit domein bevindt zich niet in dit account."; "Contact niet gevonden in dit account."; "Een of meer van de contacten zijn niet gevonden in dit account."; "Prijzen voor deze domeinextensie zijn niet beschikbaar."; "De gevraagde resource is niet gevonden."; bij de marketplace-tools: "De listing is niet gevonden."; "De onderhandeling is niet gevonden."; "De SafePay-deal is niet gevonden."; "De lease is niet gevonden."

  • Code: business.invalidArgument

    Betekenis: Het verzoek is begrepen, maar de invoer is niet acceptabel.

    Vaste detailteksten: "De gevraagde registratieperiode wordt niet ondersteund voor deze domeinextensie."; "Deze domeinextensie wordt niet ondersteund."; "De contacten zijn niet geldig voor dit domein."; "De contactgegevens zijn afgewezen."; "De service heeft het verzoek afgewezen."; bij de marketplace-tools, voor een onjuist gevormde domeinnaam (het item validationErrors noemt het veld domain met de regel pattern): "Het domein moet een domeinnaam zijn zoals "example.com"."; of een bericht dat het probleem benoemt

  • Code: business.conflict

    Betekenis: Het verzoek conflicteert met de huidige status.

    Vaste detailteksten: "Dit domein is al geregistreerd."; "Dit domein is niet beschikbaar voor registratie."; "Er bestaat al een contact met deze gegevens."; "Deze nameservers zijn al ingesteld voor dit domein."; "Het verzoek conflicteert met de huidige status van de resource."; bij de marketplace-tools: "De listing, onderhandeling of deal bevindt zich niet in een status die deze actie toestaat."; "Er loopt al een bewerking van dit type voor dit account."

  • Code: infrastructure.outcomeUnknown

    Betekenis: marketplace_offer_accept, marketplace_safepay_deal_create, marketplace_safepay_deal_confirm en marketplace_lease_cancel alleen: de actie is verzonden en de uitkomst is onbekend, dus deze kan zijn uitgevoerd. Lees de onderhandeling, deal of lease voordat u opnieuw aanroept; zie Retrying writes.

    Vaste detailteksten: "De uitkomst is onbekend: de actie kan wel of niet zijn uitgevoerd."

  • Code: infrastructure.serviceUnavailable

    Betekenis: Een verbonden service kon de aanroep niet voltooien. Probeer het later opnieuw. Zie na een mislukte schrijfbewerking Retrying writes.

    Vaste detailteksten: "Een verbonden service kon het verzoek niet voltooien."; "De service kon niet worden bereikt."; "De service antwoordde met een onverwachte fout."; "De service kon een interne aanroep niet autoriseren."

Wanneer afgewezen invoer meerdere problemen heeft, vermeldt validationErrors de parameters die de service heeft afgewezen, elk als { "field": "<parameter name>", "rule": "<kind of rejection>", "message": "<fixed text>" }. De rule is een van required, length, pattern, range, enum of generic, en de message wordt door Spaceship MCP geschreven op basis van die regel: de eigen tekst van de service wordt nooit doorgegeven. Een veld dat niet een van de eigen parameters van de tool is, wordt weggelaten, en wanneer er geen overblijft, ontbreekt validationErrors en beschrijft alleen detail de afwijzing.

Een mislukking die de service niet kan toeschrijven aan een bovenstaande situatie, zoals een onverwachte interne fout, retourneert de code infrastructure.unhandled met het vaste detail "Het verzoek kon niet worden voltooid vanwege een interne fout." Probeer zo'n aanroep later opnieuw; deze meteen herhalen helpt zelden.

Schrijfbewerkingen opnieuw proberen

Een schrijfbewerking die mislukt met infrastructure.serviceUnavailable kan toch zijn toegepast. Voordat u deze opnieuw aanroept:

  • contacts_save — zoek eerst naar het contact met contacts_list.

  • dns_records_save — lees eerst de records met dns_records_get.

  • domain_set_contacts — roep deze opnieuw aan; dezelfde contacten worden opnieuw toegewezen.

  • domain_set_nameservers — roep deze opnieuw aan. Een herhaling die vaststelt dat de nameservers al zijn ingesteld, antwoordt met de opmerking "Al ingesteld; er is niets gewijzigd."; domains_list toont de huidige nameservers, dus lees dit wanneer een antwoord u onzeker laat.

  • dns_records_delete — roep deze opnieuw aan; een record dat de eerste aanroep al heeft verwijderd, komt terug in notFound, of in unconfirmed wanneer de zone niet volledig kon worden gelezen.

  • marketplace_purchase_link — roep deze opnieuw aan; het maken van een link brengt niets in rekening, en een herhaling geeft een nieuwe link.

  • andere marketplace-schrijfbewerkingen — geen enkele wordt voor u herhaald. Lees eerst het object: een listing met marketplace_listing_get, een onderhandeling met marketplace_negotiation_get, een deal met marketplace_safepay_deal_get, een lease met marketplace_lease_get, checkout-links met marketplace_checkout_links_list en instellingen met marketplace_seller_settings_get. Na infrastructure.outcomeUnknown bij marketplace_offer_accept, marketplace_safepay_deal_create, marketplace_safepay_deal_confirm of marketplace_lease_cancel kan de actie zijn uitgevoerd: herhaal deze niet tenzij de lezing laat zien dat dit niet is gebeurd. Een import, bulkupdate of bulkannulering die antwoordde met working is actief: volg deze met async_operation_get in plaats van deze opnieuw te starten.

Tools die alleen lezen, kunnen op elk moment opnieuw worden aangeroepen. Een aanroep die is geweigerd met application.request.tooManyRequests is niet uitgevoerd: wacht even voordat u deze opnieuw aanroept.

Een geldig e-mailadres is vereist