vFound startpaginaVraag je gratis proefperiode aan
ONTWIKKELAARS

De vFound API en webhooks

Koppel de vFound-suite aan de systemen die je al gebruikt: accommodatiesystemen, servicedesks, HR- en studentensystemen, scanners in de postkamer, datawarehouses of je eigen apps. Lees en wijzig dossiers in elk product, houd je personenlijst gesynchroniseerd, ontvang binnen enkele seconden een ondertekende webhook wanneer er iets gebeurt en laat AI-assistenten helpen aan de balie.

Wil je hulp bij het instellen? Bekijk de vFound-integratiegidsen voor Cloudbeds, OfficeRnD Flex, Microsoft Entra, Slack, Microsoft Teams, Google Chat, agenda's, Zapier en MCP-clients.

Authenticatie

Elke locatie heeft de API. Een eigenaar of manager maakt tot 10 sleutels aan onder Instellingen, Voor ontwikkelaars en kiest wat elke sleutel mag doen. De volledige sleutel wordt één keer getoond. Stuur hem mee als Bearer-token:

curl https://vfound.io/api/v1/items \
  -H "Authorization: Bearer vf_live_xxxxxxxxxx_…"
ScopeStaat toeEndpoints
items:readGevonden voorwerpen, categorieën en verplaatsingen tussen locaties lezenGET /items, /items/{id}, /categories, /item-transfers
items:writeGevonden voorwerpen toevoegen en bijwerken, en ze verzenden naar of ontvangen van andere locatiesPOST /items, PATCH /items/{id}, POST /item-transfers en de bijbehorende annuleer- en ontvangstacties
claims:writeMenselijke beoordelingen van eigendom, beslissingen, goedkeuring voor vrijgave en ophalen vastleggenPOST /claims/{id}/verification, /claims/{id}/decision, /claims/{id}/release-approval, /claims/{id}/handover
lost_reports:writeMeldingen van gasten aanmaken voor een contactcenterPOST /lost-reports
claims:readClaims lezen, met de contactgegevens van de aanvragerGET /claims, /claims/{id}
lost_reports:readVerliesmeldingen van gasten lezenGET /lost-reports
analytics:readDe samenvatting van de analyses lezenGET /analytics
parcels:readPakketten lezen, met naam en e-mailadres van elke ontvangerGET /parcels, /parcels/{id}
parcels:writeRegistreren, overhandigen, retourneren en herinnerenPOST /parcels en de bijbehorende acties
checkroom:readTickets, posten, evenementen, de ophaalrij en rapporten lezenGET onder /checkroom
checkroom:writeInchecken, teruggeven, klaarzetten en posten of evenementen beherenPOST en PUT onder /checkroom
loans:readApparatuur lezen en wie het heeftGET /loans, /loans/items en van elk één
loans:writeApparatuur toevoegen, uitgeven, verlengen en innemenPOST en PATCH onder /loans
visitors:readBezoeken lezenGET /visitors, /visitors/{id}
visitors:writeUitnodigen, aan- en afmelden, annuleren, een pas sturenPOST /visitors en de bijbehorende acties
visitors:screeningBevestigen dat de screeningstreffer van een bezoeker is gecontroleerd: stuur screening_reviewed, of keur een bezoek goed dat door een treffer wordt tegengehouden. Standaard uit; wat de sleutel doet wordt vastgelegd als handeling van de sleutel, met de naam ervanPOST /visitors, /visitors/{id}/sign-in, /visitors/{id}/approve
people:readDe personenlijst lezenGET /people, /people/{id}
people:writePersonen toevoegen, bijwerken, synchroniseren en verwijderenPOST, PATCH en DELETE onder /people
stays:readPrivécontext van hotelverblijven lezen, met de correctiegeschiedenisGET /stays, /stays/{stay}
stays:writeVerblijfscontext van een hotelsysteem idempotent toevoegen of bijwerkenPOST /stays
school:readTe late aankomsten en vroeg vertrek van leerlingen lezen vanuit het schoolsecretariaatGET /school/movements
school:writeLeerlingen toevoegen of bijwerken vanuit het schoolinformatiesysteemPUT /school/pupils
queue:readWachtrijen, tickets, gereserveerde tijden, berichten, enquêtecijfers en het Queue-rapport lezenGET onder /queue
queue:writeMensen aan een rij toevoegen, ze oproepen, hun tickets afronden, tijden reserveren en annuleren en berichten sturen naar mensen in de rijPOST onder /queue
webhooks:manageDe eigen webhookadressen van de sleutel aan- en afmelden, voor gebeurtenissen waarvan de sleutel de gegevens kan lezenGET, POST en DELETE /webhooks

Voorwerpen, claims, verliesmeldingen en analyses vragen om vFound Lost & Found; pakketten vragen om vFound Parcels; tickets vragen om vFound Checkroom; apparatuur vraagt om vFound Equipment; bezoeken vragen om vFound Visitors; de personenlijst vraagt om Parcels, Visitors of Equipment; hotelverblijven vragen om Lost & Found of Parcels; het schoolsecretariaat vraagt om Visitors met het schoolsecretariaat ingeschakeld (het antwoordt 404 zolang het uit staat); wachtrijen en tickets vragen om vFound Queue. Een product dat niet is geopend voor de locatie antwoordt 403.

Een sleutel handelt als de persoon die hem heeft aangemaakt en stopt met werken als die persoon de locatie niet meer beheert, tenzij het verzoek een teamlid noemt in X-Acting-User (zie Handelen namens een teamlid). Wijzigingen met een sleutel volgen dezelfde regels, e-mails en auditlog als aan de balie, en elke auditregel noteert de sleutel die de wijziging maakte. Elke sleutel kan 120 verzoeken per minuut doen. Basisadres: https://vfound.io/api/v1. Lijsten geven 25 dossiers per pagina terug (tot 100 met per_page) en accepteren page; de meeste filteren ook op updated_since (ISO 8601) en search, zoals hieronder vermeld.

Testsleutels

Een sleutel die als testsleutel is gemaakt begint met vf_test_ en kan alleen queue:read en queue:write bevatten. Hij werkt op één gelabelde testrij, Test line (sandbox) (rij 1, balie 1), en nergens anders: dezelfde Queue-adressen als bij een echte sleutel voor rijen, tijdvakken, tickets, /queue/join, call next, call, served, no-show en remove antwoorden vanuit de testrij; elk ander adres antwoordt 403 met code: test_key. Een testsleutel leest of wijzigt nooit een echte rij of echt ticket en verstuurt geen e-mail, sms, browsermelding of webhook. Een testsleutel negeert Idempotency-Key: hetzelfde verzoek twee keer verstuurd wordt twee keer uitgevoerd. Antwoorden bevatten "sandbox": true en de header X-Vfound-Sandbox: 1. Een testrij bevat tot 100 tickets per sleutel, zonder e-mailadres, en ze worden verwijderd met de sleutel en na zeven dagen. Gebruik verzonnen namen.

Veilig opnieuw proberen

Stuur een Idempotency-Key-header mee (een willekeurige unieke waarde van maximaal 191 zichtbare tekens, zoals een UUID) bij een POST, PATCH of DELETE. Als de verbinding wegvalt en je binnen 24 uur hetzelfde verzoek opnieuw verstuurt met dezelfde sleutel, herhaalt vFound de wijziging niet: het geeft het eerste antwoord terug met de header Idempotent-Replayed: true. Dezelfde sleutel met een ander verzoek wordt geweigerd (422, idempotency_key_reused); een sleutel waarvan het eerste verzoek nog loopt antwoordt 409 (idempotency_in_progress). Nadat persoonsgegevens van vinders of aanvragers zijn gewist, geven opgeslagen antwoorden voor die locatie in plaats daarvan 410 terug, zonder de gewiste gegevens; ververs het dossier in plaats van de oude schrijfactie met een nieuwe sleutel opnieuw te proberen. Serverfouten worden niet bewaard, dus opnieuw proberen na zo'n fout voert het verzoek opnieuw uit. Een antwoord dat iets bevat dat maar één keer wordt getoond, zoals het ondertekeningsgeheim van POST /webhooks of een koppelcode voor een kiosk, wordt ook nooit opgeslagen: een nieuwe poging voert het verzoek opnieuw uit, dus controleer GET /webhooks voordat je hetzelfde adres twee keer aanmeldt.

Handelen namens een teamlid

Een app die je team aan de balie gebruikt, zoals een app voor een post of depot, kan aangeven namens welk teamlid hij handelt. Stuur X-Acting-User mee met het inlogadres van de persoon of hun gebruikers-id. Die persoon moet op dat moment een actief lid zijn van de locatie van de sleutel. Het verzoek wordt dan uitgevoerd als die persoon: de geschiedenis van het voorwerp en van de claim noemt die persoon in plaats van de maker van de sleutel, en het auditlog noemt die persoon, de sleutel en de manager die de sleutel heeft aangemaakt. Ze kunnen alleen doen wat zowel de scopes van de sleutel als hun eigen rol op de locatie toestaan: een kijker kan alleen lezen, medewerkers kunnen ook voorwerpen, claims, verliesmeldingen, pakketten, checkroomtickets, apparatuur, bezoeken en hotelverblijven wijzigen, en eigenaren en managers kunnen elke scope gebruiken die de sleutel heeft. Een naam die geen actief lid van de locatie is, wordt geweigerd met 403 en acting_user_refused, met dezelfde melding of het adres nu bestaat of niet; een scope die de rol van de persoon niet toestaat, wordt geweigerd met 403 en acting_user_role. Veilig opnieuw proberen wordt per persoon bewaard, dus het opgeslagen antwoord van de ene persoon wordt nooit voor een ander afgespeeld. De header werkt alleen met locatiesleutels, niet met een assistent die via inloggen is gekoppeld en al handelt als de persoon die hem heeft gekoppeld. vFound controleert dat de genoemde persoon een actief lid is; het vraagt die persoon niet om in te loggen, dus noem alleen mensen vanuit een app waarin je team inlogt. Zonder de header werkt een sleutel precies zoals voorheen.

OpenAPI

De hele API, elke gebeurtenis en elk object staat beschreven in een OpenAPI 3.1-bestand: vfound.io/openapi/v1.json. Importeer het in Postman, Insomnia of je eigen codegenerator. Een test houdt het gelijk met de API, dus het noemt nooit een endpoint dat niet bestaat en mist er nooit een dat wel bestaat.

Kant-en-klare koppelingen met operationele systemen

Eigenaren en managers stellen deze alleen-lezen koppelingen met aanbieders in onder Instellingen, Koppelingen, Operationele systemen. Ze staan los van de openbare REST API: de klant maakt en beheert de inloggegevens bij de aanbieder, de koppeling moet een test doorstaan voordat hij wordt geactiveerd, herhaalde fouten pauzeren alleen die koppeling en handwerk blijft beschikbaar.

SysteemWat vFound leestvFound-onderdelen
CloudbedsMinimale reserverings- en kamercontext via een sleutel van de accommodatie die de klant zelf beheert en die beperkt is tot read:reservation. Onderdeel van vFound Enterprise.Privéverblijven voor Lost & Found en Parcels
OfficeRnD FlexLid-id, naam, e-mailadres en actieve status via flex.community.members.read, met een optioneel locatiefilter.De gedeelde personenlijst voor Parcels, Equipment en Visitors
Microsoft Entra IDGebruikers-id, weergavenaam, e-mailadres en actieve status via Microsoft Graph-deltaupdates en door een beheerder goedgekeurde User.Read.All.De gedeelde personenlijst voor Parcels, Equipment en Visitors

Dit zijn API-koppelingen die de klant zelf instelt, geen beweringen over certificering door een leverancier. Een koppeling testen, inschakelen en synchroniseren hoort bij vFound Enterprise. De Entra-koppeling is in het bijzonder geen app in de Microsoft Marketplace.

Oracle OPERA Cloud is niet beschikbaar. De adapter aan de serverkant, die bij fouten gesloten blijft, blijft uitgeschakeld totdat Oracle-toegang, de goedkeuring van het hotel, de exacte omgevingsconfiguratie en live acceptatie zijn afgerond. Hij wordt niet aangeprezen als gecertificeerd of door klanten gevalideerd.

Voorwerpen

VerzoekWat het doetScope
GET/itemsVoorwerpen, de laatst gewijzigde eerst. Filters: status, search (woorden in de titel, beschrijving, het merk, de kleur of de tags), updated_since (ISO 8601), page, per_page (tot 100).items:read
GET/items/{id}Eén voorwerp op basis van zijn id.items:read
GET/categoriesDe categorienamen die een voorwerp kan gebruiken.items:read
POST/itemsVoeg een gevonden voorwerp toe. Het wordt gepubliceerd op je pagina voor gasten, start meldingen en matching, en verschijnt in je auditlog net als een voorwerp dat met de hand is toegevoegd.items:write
PATCH/items/{id}Wijzig details of status.items:write
GET/item-transfersGevonden voorwerpen die deze locatie naar een andere locatie van dezelfde klantgroep heeft gestuurd of ervan ontvangt, met voorwerpen die onderweg zijn eerst. Toont ook de locaties waarnaar je kunt sturen (destinations) en de opslagbakken van deze locatie (bins). Filters: status (in_transit, received of cancelled), direction (incoming of outgoing).items:read
POST/item-transfersStuur een voorwerp dat op zijn eigenaar wacht naar een andere locatie van de groep: item_id, destination_business_id en een optionele note. Alleen voor sleutels die een eigenaar of manager heeft gemaakt. Het voorwerp verdwijnt van de pagina voor gasten van de verzendende locatie (als die locatie haar gevonden voorwerpen toont) en kan niet meer wijzigen totdat het is aangekomen. Een voorwerp met een claim blijft waar het is.items:write
POST/item-transfers/{id}/cancelDe verzendende locatie neemt het voorwerp terug voordat het is ontvangen.items:write
POST/item-transfers/{id}/receiveDe ontvangende locatie bevestigt dat het is aangekomen, met bin_id (verplicht als de locatie opslagbakken heeft) of location. Het voorwerp hoort dan bij deze locatie, met zijn foto's, geschiedenis en data, en wordt vergeleken met de verliesmeldingen van deze locatie net als een nieuw geregistreerd voorwerp.items:write

Hulpmiddelen voor de balie van Lost & Found en Checkroom

Nieuwe e-mailinstellingen staan standaard uit. Scantellingen en afwijkingen bij het sluiten dienen alleen ter controle. P90 gebruikt het 90e percentiel volgens de nearest-rank-methode van geldige tijdsintervallen; ontbrekende metingen geven null terug. De fysieke capaciteit in stuks waarschuwt, maar blokkeert het inchecken nooit. Zie de OpenAPI-beschrijving voor de velden van een verzoek. Sjablonen voor het instellen en instellingen vragen om een eigenaar of manager.

Methode en padWat het doetScope
GET /lost-found/context-schemaLees versiebeheerde definities van privécontextvelden, zonder waarden van dossiers. Elk van de genoemde leesscopes is voldoende.items:read of lost_reports:read
GET /lost-found/desk-settingsLees de optionele instellingen van de balie.lost_reports:read
PUT /lost-found/desk-settingsVervang de instellingen van de balie; alleen eigenaar of manager. Nieuwe mailinstellingen staan standaard uit.lost_reports:write
GET /checkroom/desk-settingsLees de optionele instellingen van de balie.checkroom:read
PUT /checkroom/desk-settingsVervang de instellingen van de balie; alleen eigenaar of manager. Nieuwe mailinstellingen staan standaard uit.checkroom:write
GET /lost-found/countsToon de laatste 30 telsessies met scans.items:read
POST /lost-found/countsMaak een momentopname van de identificatiegegevens van vastgehouden voorwerpen voor een telling die alleen rapporteert; er verandert niets aan de bewaring.items:write
GET /lost-found/counts/{id}Lees een telling met de cijfers voor ontbrekende, onverwachte en niet meer aanwezige voorwerpen.items:read
POST /lost-found/counts/{id}/scanLeg een scan van een QR-code of kort voorwerplabel vast; bekende voorwerpen die dubbel worden gescand tellen één keer.items:write
POST /lost-found/counts/{id}/finishRond een telling af zonder voorwerpen te wijzigen.items:write
GET /lost-found/queuesToon de opgeslagen werkwachtrijen van de huidige maker van de sleutel op deze locatie.lost_reports:read
PUT /lost-found/queues/{id}Vervang je eigen opgeslagen wachtrij; onderliggende voorwerpen en claims blijven ongewijzigd.lost_reports:write
DELETE /lost-found/queues/{id}Verwijder je eigen opgeslagen wachtrij; onderliggende voorwerpen en claims blijven ongewijzigd.lost_reports:write
POST /lost-found/queuesSla een werkwachtrij met een naam op als voorinstelling voor de huidige maker van de sleutel.lost_reports:write
GET /lost-found/queues/{id}Lees de actuele dossiers achter een opgeslagen wachtrij. Binnenkomende verplaatsingen openen de bestaande weergave van de verplaatsing met bijbehorende rechten.lost_reports:read, items:read, claims:read
POST /lost-found/intake-reviewGeef deterministische meldingen over volledigheid en privacy terug; geen AI en geen wijzigingen.items:read
GET /checkroom/templatesToon sjablonen die alleen configuratie bevatten; alleen voor managers.checkroom:read
PUT /checkroom/templates/{id}Vervang een sjabloon als manager; onderliggende evenementen, posten en tickets blijven ongewijzigd.checkroom:write
DELETE /checkroom/templates/{id}Verwijder een sjabloon als manager; onderliggende evenementen, posten en tickets blijven ongewijzigd.checkroom:write
POST /checkroom/templatesSla de configuratie van de posten van een evenement op zonder gasten of tickets; alleen voor managers.checkroom:write
POST /checkroom/templates/{id}/applyMaak een nieuw evenement en nieuwe posten; botsingen met actieve nummerreeksen weigeren de hele bewerking.checkroom:write

Contactcenter en bewaring bij Lost & Found

Door mensen bediende integraties kunnen een melding van een gast aanmaken, een beoordeling van eigendom vastleggen, over een claim beslissen en het fysiek ophalen vastleggen. Nieuwe schrijfscopes moeten uitdrukkelijk worden gekozen; bestaande sleutels krijgen ze niet. Geen van deze schrijfacties voor claims of afhandeling wordt aangeboden als MCP-tool of Ask vFound-tool. Je integratie is verantwoordelijk voor het identificeren en autoriseren van de eigen menselijke bediener: het auditlog noemt de manager die de sleutel heeft aangemaakt en, wanneer de integratie X-Acting-User meestuurt, ook het teamlid dat daarin is genoemd en dat vFound niet authenticeert.

Methode en padWat het doetScope
POST /lost-reportsIntake via het contactcenter: first_name, last_name, email, title en description; optioneel phone, category id, colour_brand, place_lost, date_lost en language. Verstuurt de gebruikelijke bevestiging aan de gast en de privélink en start de bewaking van 90 dagen. Toestemming voor telefoon wordt nooit afgeleid. De bestaande limieten voor openstaande meldingen gelden.lost_reports:write
PUT /lost-reports/{id}Bewerk wat verloren is gegaan met de vingerafdruk die GET /lost-reports teruggeeft. Titel en beschrijving zijn verplicht. Een weggelaten journey behoudt de opgeslagen details; als het verzamelen is uitgeschakeld, worden wijzigingen in de context geweigerd. Wijzigingen in contactgegevens vragen om de aparte gecontroleerde contactflow.lost_reports:write
GET /lost-reports/{id}/matchesTot 24 actuele kandidaten op basis van tekst en categorie, elk met match.label, reason en source. Recent opgeslagen AI-oordelen gebruiken cached_ai; anders wordt een trefwoordsuggestie als possible gemarkeerd. Geen nieuwe modelaanroep en geen beslissing over eigendom.lost_reports:read en items:read
GET /items/{id}/matchesId en titel van de bijpassende melding zonder contactgegevens van de melder; tot 24 treffers uit de laatste 1,000 openstaande meldingen. Dezelfde bronlabels en geen nieuwe modelaanroep.items:read en lost_reports:read
POST /claims/{id}/verificationLeg verified (boolean) en method (distinctive_details, purchase_proof of staff_review) vast. Verklaring door een mens, geen geautomatiseerde echtheidscontrole van documenten; geen kopie van een document en geen bewijs in vrije tekst. De laatste beoordeling moet slagen voordat de API een claim accepteert.claims:write
POST /claims/{id}/decisionstatus: open, accepted, rejected, expired, ready_for_pickup, ready_for_shipment, shipped of handed_to_courier. De bestaande statusmachine en de tweede goedkeuring gelden. Velden voor handmatige verzending volgen de regels van de werkruimte. Bij accepted verplaatst een optionele return (pickup of shipment) de claim in hetzelfde verzoek naar die fase, met één e-mail aan de aanvrager; als een vrijgave van hoge waarde nog een tweede goedkeuring nodig heeft, blijft de claim accepted en zegt return_notice waarom (hetzelfde verzoek nogmaals wijzigt niets). Een optionele arranged_by (site of owner) geeft aan wie een koerier of postretour boekt, en elk antwoord over een claim toont dit. Zonder arranged_by betekent een bezorgadres in shipment (of een adres dat de claim al heeft) dat je team het opstuurt, zoals voorheen; anders beslist de Lost & Found-instelling van de locatie. owner betekent dat de eigen koerier van de aanvrager het voorwerp ophaalt: er wordt geen adres gevraagd, een adres dat met owner wordt meegestuurd wordt geweigerd en shipped wordt geweigerd. Als hun koerier het ophaalt, stuur je handed_to_courier met het koeriersbedrijf in shipment.carrier en zijn boekingsreferentie in shipment.tracking_number; de claim wordt afgesloten. Om te wijzigen wie het boekt, zet je de claim naar ready_for_pickup en weer naar ready_for_shipment met arranged_by.claims:write
POST /claims/{id}/release-approvalEen andere manager keurt een geaccepteerde vrijgave van hoge waarde goed, met dezelfde controles als in de werkruimte.claims:write
GET /claims/{id}/custodyBekijk de geschiedenis van beoordeling en fasen, de goedkeurder en de naam en tijd van het ophalen. signature_recorded is een boolean; er wordt geen handtekeningafbeelding of privé bestandsadres getoond.claims:read
POST /claims/{id}/handoverLeg het fysiek ophalen vast vanuit ready_for_pickup, met handover.name en, wanneer vereist, een PNG-data-URL in handover.signature. Herhaalde aanroepen voor een afgesloten claim behouden de eerste ontvangstbevestiging.claims:write
POST /items/{id}/dispositionkind donated/disposed, recipient voor een schenking, optionele notes. De controles op de bewaartermijn en op openstaande of geaccepteerde claims gelden. Geeft de genummerde batchbevestiging terug.items:write

Gebruik een Idempotency-Key bij pogingen om te schrijven opnieuw te proberen. Een beoordeling is geen echtheidscontrole van een identiteitsdocument en keurt zelf geen eigendom goed. Het aanmaken van een eerste melding volgt de workflow voor gasten, inclusief AI die de locatie heeft ingeschakeld; GET-aanroepen voor lijsten met treffers gebruiken opgeslagen oordelen en alleen zoeken in tekst. Dit zijn algemene REST/OpenAPI-bewerkingen; er is geen WSO2-installatie of eigen connector gecertificeerd.

Een voorwerp toevoegen

curl https://vfound.io/api/v1/items -X POST \
  -H "Authorization: Bearer $VFOUND_KEY" -H "Content-Type: application/json" \
  -d '{"title":"Black leather wallet","category":"Wallets & Purses","found_date":"2026-09-23",
       "location":"Front desk","colour":"Black","brand":"Fossil","tags":["leather","cards"],
       "photo":"data:image/jpeg;base64,…","photo_public":true}'

Velden: title en category zijn verplicht. Optioneel: found_date, found_time (HH:MM), keep_until, location, description, colour, brand, tags, value_band (unknown, low, medium, high), notes (alleen voor medewerkers), photo (een base64-data-URL tot 8 MB) en photo_public. Foto's die via de API worden verstuurd, worden niet gecontroleerd door de privacybewaking van vFound AI, dus zet photo_public op false voor elke foto waarop persoonsgegevens te zien zijn.

Het voorwerpobject

{"id":"9b2f…","title":"Black leather wallet","status":"in_care","category":"Wallets & Purses",
 "found_date":"2026-09-23","found_time":"14:30","keep_until":"2026-10-21","location":"Front desk",
 "description":null,"colour":"Black","brand":"Fossil","tags":["leather","cards"],"value_band":"low",
 "photo_public":true,"photo_url":"https://vfound.io/uploads/…","transfer":null,"created_at":"…","updated_at":"…"}

Status is een van in_care, in_transit (onderweg naar een andere locatie; transfer noemt dan beide locaties), claimed, expired, donated, disposed of trash. Een PATCH mag in_care, expired, donated, disposed of trash instellen; teruggaven aan een gast verlopen via claims.

Claims

VerzoekWat het doetScope
GET/claimsClaims, de laatst gewijzigde eerst. Filters: status, updated_since, page, per_page.claims:read
GET/claims/{id}Eén claim op basis van zijn referentie.claims:read
{"id":"k3f9x2a1b7c4d8e6","status":"ready_for_pickup","item":{"id":"9b2f…","title":"Black leather wallet"},
 "claimant":{"first_name":"Ana","last_name":"Ruiz","email":"ana@example.com","phone":null},
 "description":"…","place_lost":"Bar","date_lost":"2026-09-22","language":"es","arranged_by":null,"created_at":"…","updated_at":"…"}

Claimstatus: unread, open, accepted, awaiting_information, ready_for_pickup, ready_for_shipment, shipped, closed, rejected of expired (geaccepteerd maar nooit opgehaald). arranged_by geeft aan wie een koerier of postretour boekt: venue (je team stuurt het op) of owner (de eigen koerier van de aanvrager haalt het op); null wanneer de claim zo'n retour niet heeft. De gegevens van aanvragers zijn persoonsgegevens: bewaar ze alleen zolang je ze nodig hebt.

Verliesmeldingen

GET/lost-reports toont wat gasten als verloren hebben gemeld, met status (open of closed), de contactgegevens van de melder, de taal die ze gebruikten en een eventuele Find My-link die ze hebben gedeeld. Scope: lost_reports:read.

Analyses

GET/analytics?days=30 geeft dezelfde samenvatting terug als Rapporten: geregistreerde en teruggegeven voorwerpen, teruggavepercentage, mediaan van het aantal dagen tot teruggave, waar voorwerpen terechtkwamen, categorieën, hotspots, drukste dagen, werk van het team, de trend en feedback van gasten. days is 7, 30, 90 of 365. Scope: analytics:read.

Hotelverblijven

Verblijfscontext is privé voor de locatie en bewust minimaal. Hij bevat een vaste verblijfsreferentie, een optionele gastreferentie, de naam van de gast, aankomst en vertrek, de tijdzone van de bron, de huidige kamer, de status en tijdstempels van de bron. Hij bevat nooit tarieven, betaalgegevens, loyaliteitsgegevens, identiteitsdocumenten, voorkeuren of niet-gerelateerde reserveringsnotities.

VerzoekWat het doetScope
GET/staysVerblijven tonen. Filters: search (gast, vaste referentie of huidige kamer), state, source, page en per_page. Een treffer op kamer helpt alleen bij het navigeren; hij suggereert nooit wie de eigenaar is.stays:read
GET/stays/{stay}Eén verblijf met de bijbehorende controleerbare geschiedenis van bron en correcties.stays:read
POST/staysMaak het API-brondossier aan of werk het bij, geïdentificeerd door external_stay_ref. Stuur source_updated_at mee; vertraagde of opnieuw afgespeelde gebeurtenissen die niet nieuwer zijn dan de opgeslagen gebeurtenis worden bevestigd zonder nieuwere gegevens te vervangen.stays:write
curl https://vfound.io/api/v1/stays -X POST \
  -H "Authorization: Bearer $VFOUND_KEY" -H "Idempotency-Key: pms-event-901" \
  -H "Content-Type: application/json" \
  -d '{"external_stay_ref":"BOOK-100","guest_name":"Avery Chen","current_room":"412",
       "stay_state":"in_house","source_timezone":"America/New_York","source_updated_at":"2026-10-03T12:00:00Z"}'

Voorwerpen en pakketten accepteren optioneel stay_id en room_at_event. Als de kamer ten tijde van de gebeurtenis wordt weggelaten, legt vFound de huidige kamer van het verblijf vast. Die momentopname verandert niet na een kamerwissel; het dossier toont ook de huidige kamer, zodat de balie beide ziet.

Parcels

VerzoekWat het doetScope
GET/parcelsPakketten, de laatst gewijzigde eerst. Filters: status (waiting, collected of returned), search (ontvanger, unit, trackingnummer, afzender of ophaalcode), updated_since.parcels:read
GET/parcels/{id}Eén pakket.parcels:read
POST/parcelsRegistreer een pakket voor recipient_email (gekoppeld aan je personenlijst) of recipient_name, met optioneel unit, carrier, tracking, sender en shelf. De persoon krijgt zijn ophaalcode per e-mail, tenzij notify false is.parcels:write
POST/parcels/{id}/collectOverhandig het: collected_by (verplicht) en een optionele signature (een PNG-data-URL).parcels:write
POST/parcels/{id}/returnStuur het terug naar de afzender, met een optionele note.parcels:write
POST/parcels/{id}/remindStuur de ontvanger een herinnering per e-mail om het op te halen.parcels:write
POST/parcels/trackingNormaliseer een trackingnummer en herken UPS, FedEx, USPS, DHL, Amazon of een internationale S10-vervoerder. Een geldige GS1 SSCC wordt geaccepteerd als zendingstracking; een GS1-productidentificatie wordt herkend maar nooit als pakketnummer behandeld.parcels:read
GET/parcels/pickup-queueMensen die hebben aangegeven dat ze bij de balie zijn, met hun aantal pakketten en planken.parcels:read
POST/parcels/pickup-queue/{id}/serveMarkeer één aankomst bij de balie als geholpen.parcels:write
POST/parcels/bulk-remindStuur herinneringen per e-mail voor maximaal 200 geselecteerde wachtende pakketten.parcels:write
POST/parcels/bulk-returnStuur maximaal 200 geselecteerde wachtende pakketten terug naar de afzender.parcels:write
GET/parcels/shelvesDe capaciteit van de pakketplanken en de huidige bezetting.parcels:read
POST/parcels/shelvesMaak een plank aan of wijzig de capaciteit ervan.parcels:write
GET/parcels/analyticsVolume, verdeling per vervoerder, ophaaltijd, percentage niet opgehaald en drukste planken.parcels:read
GET/parcels/outgoingUitgaande pakketten die klaarstaan voor een koerier of zijn overgedragen.parcels:read
POST/parcels/outgoingRegistreer een uitgaand pakket.parcels:write
POST/parcels/outgoing/{id}/handoffLeg de koerier en handtekening vast bij de overdracht.parcels:write
GET/parcels/roundsBezorgrondes en hun stops.parcels:read
POST/parcels/roundsMaak een ronde over de campus of het kantoor van wachtende pakketten.parcels:write
POST/parcels/rounds/{round}/stops/{stop}/deliverRond een stop af met de naam van de ontvanger en een handtekening.parcels:write
GET/parcels/couriersKoeriers die via Visitors zijn geregistreerd, met status in of out.parcels:read
{"id":412,"status":"waiting","recipient":{"name":"Ana Ruiz","email":"ana@example.com","unit":"Room 214","reference":"S1044"},
 "carrier":"UPS","tracking":"1Z999AA10123456784","sender":null,"size":"small","shelf":"B2","pickup_code":"KQHRER",
 "notified_at":"…","collected_at":null,"collected_by":null,"returned_at":null,"created_at":"…","updated_at":"…"}

De ophaalcode wordt alleen getoond zolang het pakket wacht. De gegevens van ontvangers zijn persoonsgegevens: bewaar ze alleen zolang je ze nodig hebt.

Checkroom

VerzoekWat het doetScope
GET/checkroom/ticketsTickets, de laatst gewijzigde eerst, met status (pending, in, returned, left of moved), het nummer, wat is ingeleverd, afzonderlijk gelabelde piece_records, de gegevens van de gast als die zijn opgegeven, de kosten die aan de balie zijn vastgelegd en de tijden. Filters: status, search (gast, kamer, ticketnummer, stuklabel of ticketcode), updated_since.checkroom:read
GET/checkroom/tickets/{id}Eén ticket.checkroom:read
POST/checkroom/ticketsCheck iets in en krijg het volgende vrije nummer: kind (coat, bag, luggage of other, verplicht), pieces, optioneel piece_details met één soort en opslagplek per stuk, guest_name, guest_email, guest_room, collect_by voor bagage, notes, fee_method (cash of card), station_id, event_id, storage_location, language en photo. Het antwoord bevat ook één keer guest_ticket (de code en het privéadres van het ticket), om als QR-code te tonen of voor de gast af te drukken; lezen, lijsten en webhooks bevatten het nooit.checkroom:write
POST/checkroom/tickets/{id}/hand-backGeef het terug zodra je systeem het ticket van de gast heeft gelezen, met optioneel collected_by en signature. Stuur piece_ids mee om geselecteerde stukken terug te geven en de andere open te laten; laat het weg om elk openstaand stuk terug te geven. without_ticket legt vast dat de gast zijn ticket kwijt is en vraagt dan om collected_by en signature.checkroom:write
GET/checkroom/stationsToon de checkroomposten, nummerreeksen en opslagplekken van de locatie.checkroom:read
POST/checkroom/stationsMaak een post aan met een nummerreeks die niet overlapt.checkroom:write
PUT/checkroom/stations/{id}Wijzig een post, zijn nummerreeks, opslagplekken of actieve status.checkroom:write
GET/checkroom/eventsToon recente en aankomende checkroomevenementen.checkroom:read
POST/checkroom/eventsMaak een evenement aan met het verwachte volume en de posten.checkroom:write
PUT/checkroom/events/{id}Wijzig de tijden, de prognose of de posten van een evenement.checkroom:write
GET/checkroom/exit-queueTickets waarvan de gasten de balie hebben gevraagd hun spullen klaar te zetten.checkroom:read
POST/checkroom/tickets/{id}/readyMarkeer een wachtend ticket als klaar en breng de gast op de hoogte.checkroom:write
GET/checkroom/reportTicketvolume, piekuren, teruggavetijd en kosten per methode en per medewerker.checkroom:read
GET/checkroom/exportDownload de rijen van het checkroomrapport als CSV die veilig is voor formules.checkroom:read

Queue

Rijen, de mensen die erin wachten en de balies waar ze naartoe worden geroepen. Elke wijziging doorloopt dezelfde stappen als aan de balie, met dezelfde geschiedenis, als de maker van de sleutel of het teamlid dat in X-Acting-User staat. Een ticket bevat nooit het e-mailadres van de gast of zijn antwoorden op de vragen van de rij.

VerzoekWat het doetScope
GET/queue/linesRijen met hun toestand nu, de mensen die wachten en een geschatte wachttijd voor wie nu aansluit.queue:read
GET/queue/lines/{id}Eén rij.queue:read
GET/queue/ticketsTickets van één dag van de locatie (day, standaard vandaag), in de volgorde van oproepen; filter op line en status.queue:read
GET/queue/tickets/{id}Eén ticket.queue:read
GET/queue/reportTickets, geholpen mensen, no-shows, mensen die zijn vertrokken, en mediane wacht- en servicetijd in minuten over de laatste days.queue:read
POST/queue/ticketsVoeg een persoon toe aan een rij, zoals de balie dat doet.queue:write
POST/queue/call-nextRoep de volgende persoon op naar een balie (counter_id). Twee oproepers krijgen nooit dezelfde persoon; data is null als er niemand wacht.queue:write
POST/queue/tickets/{id}/callRoep een gekozen persoon op naar een balie.queue:write
POST/queue/tickets/{id}/servedMarkeer de persoon bij een balie als geholpen.queue:write
POST/queue/tickets/{id}/no-showMarkeer een opgeroepen persoon die niet is gekomen als no-show.queue:write
POST/queue/tickets/{id}/removeHaal een persoon uit de rij.queue:write
GET/queue/bookingsGereserveerde tijden, de vroegste eerst, met from, to, line, status en paginering. Nooit het e-mailadres van de persoon.queue:read
POST/queue/bookingsReserveer een van de vrije tijden van de pagina met gereserveerde tijden van een rij voor een persoon (line_id, starts_at, email).queue:write
POST/queue/bookings/{id}/cancelAnnuleer een gereserveerde tijd; de persoon krijgt een e-mail dat het team hem heeft geannuleerd.queue:write
POST/queue/bookings/{id}/arrivedMeld een persoon met een gereserveerde tijd aan; zijn ticket wordt geplaatst op basis van de gereserveerde tijd.queue:write
POST/queue/tickets/{id}/arrivedMarkeer een persoon die aansloot voordat hij er was als aanwezig.queue:write
GET/queue/tickets/{id}/messagesDe berichten tussen een persoon in de rij en het team, de oudste eerst. Door te lezen worden de berichten van de persoon als gelezen gemarkeerd.queue:read
POST/queue/tickets/{id}/messagesSchrijf naar een persoon in de rij (body, 1 tot 500 tekens), als het teamlid van de sleutel.queue:write
GET/queue/surveyEnquêtecijfers na afloop van de service: antwoorden, gemiddelde, elke beoordeling, per rij, service, balie en teamlid (het gemiddelde van een teamlid verschijnt vanaf 5 antwoorden). Nooit opmerkingen.queue:read
GET/queue/performanceGewone cijfers voor elk teamlid over dezelfde dagen als het rapport. Geen score en geen ranglijst.queue:read
GET/queue/lines/{id}/slotsDe open gereserveerde tijden van een rij, zoals de boekingspagina ervan ze aanbiedt.queue:read
POST/queue/joinNeem een nummer voor een gast van je eigen website, volgens de regels voor gasten (open rij, limieten, verplichte antwoorden en toestemmingsvakjes). Stuur het vanaf je server: de sleutel vervangt de captcha.queue:write
GET/queue/tickets/lookupZoek tickets op basis van het nummer dat de gast heeft.queue:read
GET/queue/tickets/{id}/statusWat de eigen ticketpagina van de gast toont: plaats, schatting en zin.queue:read
GET/queue/tickets/{id}/historyDe stappen van één ticket. Wie elke stap deed, is team, guest, api (aansluiten via een sleutel) of system (automatisch gedaan, zoals de automatische no-show), nooit een naam.queue:read
GET/queue/customers/historyBezoeken van iemand die heeft gevraagd te worden onthouden, gevonden via e-mailadres, zolang de locatie herkenning heeft ingeschakeld. Het vertelt de sleutelhouder of een e-mailadres bij een onthouden bezoeker hoort.queue:read
GET/queue/insightsTellingen over dezelfde dagen als het rapport: mensen die vertrokken voordat ze werden opgeroepen, mensen met een gereserveerde tijd en mensen zonder afspraak, het aandeel dat binnen het wachtdoel is opgeroepen per rij en week, en drukke uren uit eerdere weken. Alleen tellingen; nooit een naam of een antwoord.queue:read
GET/queue/report-dataDe Queue-tickets zoals de rapportbouwer ze leest (fields[], limit tot 1000, offset), voor BI-tools. De naam van de gast wordt nooit meegegeven.queue:read

Equipment

VerzoekWat het doetScope
GET/loansApparatuur die is uitgegeven, de laatst gewijzigde eerst, met status (out, returned of lost), of het overdue is, het artikel, de persoon en de tijden. Filters: status (out, returned, lost of overdue), search (naam, e-mailadres of referentie van de persoon), updated_since.loans:read
GET/loans/{id}Eén uitgifte.loans:read
POST/loansGeef iets uit: item_id of item_code (de code op het label, of de link in de QR-code), borrower_name (verplicht), optioneel person_id om de personenlijst te koppelen, borrower_email voor een bon, borrower_reference, due_at, note, language en signature.loans:write
POST/loans/{id}/extendGeef meer tijd: een nieuwe due_at. De persoon krijgt de nieuwe tijd per e-mail.loans:write
POST/loans/{id}/returnNeem het in, met een optionele condition (good, damaged of incomplete), note en set_aside om het artikel opzij te leggen voor reparatie.loans:write
POST/loans/returnsNeem meerdere dingen tegelijk in: loan_ids (1 tot 50), met dezelfde optionele condition, note en set_aside voor alle. Alles of niets: als er één al terug is of niet wordt gevonden, verandert er niets. Een persoon met een e-mailadres krijgt één bon voor elke uitgifte, met alles wat terugkwam, en elke uitgifte stuurt zijn eigen loan.returned-gebeurtenis.loans:write
GET/loans/itemsAlles wat de balie uitgeeft, op naam. Filters: status (available, out, repair of retired), search (naam, inventarislabel of labelcode), updated_since.loans:read
GET/loans/items/{id}Eén artikel, met de link die de QR-code van het label bevat.loans:read
GET/loans/items/{id}/ticketsTickets die naar de eigen Jira, Zendesk of ServiceNow van de locatie zijn gestuurd voor dit artikel (bèta), met de laatst teruggelezen status.loans:read
POST/loans/itemsVoeg apparatuur toe: name (verplicht), category, tag, location, notes, loan_hours (hoeveel uur het gewoonlijk wordt uitgegeven), photo, product en variant (units van één product en variant kunnen als één worden geboekt), en copies om maximaal 50 identieke, genummerde artikelen toe te voegen.loans:write
PATCH/loans/items/{id}Wijzig de gegevens, of zet status op available, repair of retired. product en variant wijzigen de productfamilie; cleaning_status needs_cleaning markeert het als wachtend op schoonmaak en null markeert het als schoongemaakt. Artikelen tonen product, variant, cleaning_status en cleaning_since.loans:write
GET/loans/items/{id}/tagOf een NFC- of RFID-tag is gekoppeld, en de laatste vier hexadecimale cijfers van het serienummer.loans:read
PUT/loans/items/{id}/tagKoppel een tag via zijn serienummer, zoals een telefoon het leest of een lezer die als toetsenbord typt het intypt (hex, omgekeerde hex of decimaal); het vervangt elke tag die het artikel had.loans:write
DELETE/loans/items/{id}/tagVerwijder de tag van het artikel.loans:write
POST/loans/checkoutsGeef één tot 50 artikelen uit in één atomaire uitgifte, of geef een opgeslagen set uit. Het accepteert een persoon, inlevertijd, notitie en optionele handtekening, en voorraadregels (stock) die op dezelfde bon worden uitgegeven en teruggegeven in stock. custom_values stelt de eigen kenmerken van de locatie voor de uitgifte in.loans:write
GET/loans/kitsOpgeslagen groepen apparatuur die meestal samen worden uitgegeven.loans:read
POST/loans/kitsSla een set op van in totaal minstens twee onderdelen: item_ids met naam, lines (een aantal van een categorie) en child_kit_ids (sets erin, tot drie niveaus), stock_lines (getelde voorraad die ermee wordt uitgegeven, nooit vastgehouden voor een boeking), optioneel locked zodat de artikelen met naam alleen samen worden uitgegeven.loans:write
PUT/loans/kits/{id}Wijzig een opgeslagen set en zijn artikelen.loans:write
GET/loans/trainingsDe trainingen die een categorie of artikel kan vereisen voordat iemand het meeneemt (in te stellen onder Equipment, Beleid, Training).loans:read
GET/loans/trainings/{id}/holdersWie een training heeft, vanaf wanneer en tot wanneer, en of die is verlopen.loans:read
POST/loans/trainings/{id}/holdersGeef een persoon op de personenlijst een training, of verleng hem, met een optioneel bewijsdocument.loans:write
DELETE/loans/trainings/{id}/holders/{person}Neem een training weg bij een persoon, met zijn bewijsdocument.loans:write
GET/loans/borrower-typesDe persoonstypen: de artikellimiet, gebruikelijke duur en de categorieën die de mensen van elk type zien en kunnen meenemen (in te stellen onder Equipment, Beleid, ‘Gebruikerstypen’). Een lege limiet of duur betekent dat die van de locatie zelf geldt.loans:read
GET/loans/borrower-types/{id}/membersWie een persoonstype heeft.loans:read
POST/loans/borrower-types/{id}/membersGeef mensen op de personenlijst een persoonstype (tot 500 tegelijk).loans:write
PUT/loans/borrower-types/{id}/members/{person}Wijzig het lidmaatschap van een persoon van een persoonstype: de begindag, de einddag (daarna zien ze nog wat het type toont, maar kunnen ze het niet reserveren of meenemen) en een notitie over waar een bedrag is afgeschreven. vFound neemt geen betaling aan.loans:write
DELETE/loans/borrower-types/{id}/members/{person}Neem een persoonstype weg bij een persoon.loans:write
GET/loans/creditsRecent gegeven boekingstegoeden en het saldo van één persoon. Tegoeden zijn een aantal dat boekingen verbruiken, nooit geld.loans:read
POST/loans/creditsGeef een persoon boekingstegoeden, of neem er terug met een negatief getal (eigenaren en managers).loans:write
GET/loans/holdsActieve blokkades op het meenemen: zolang er een duurt, wordt er niets aan de persoon uitgegeven en kan die niet boeken.loans:read
POST/loans/holdsZet een blokkade op het meenemen door een persoon, met een optionele reden (bewaard voor het team, nooit in de e-mail), eindtijd en e-mail aan de persoon.loans:write
POST/loans/holds/{id}/liftHef een blokkade op.loans:write
GET/loans/spacesKamers, werkplekken, parkeerplaatsen en andere plekken die de locatie voor een bepaalde tijd boekt, optioneel gefilterd op type. Elk is een artikel met kind space, dat nooit wordt uitgegeven.loans:read
POST/loans/spacesVoeg een kamer of ruimte toe met zijn type, hoeveel mensen erin passen en waar hij is.loans:write
PUT/loans/spaces/{id}Wijzig een kamer of ruimte.loans:write
GET/loans/spaces/availabilityElke kamer of ruimte met zijn open boekingen tussen from en to (tot 31 dagen), met de naam van de persoon, hoeveel mensen komen en eventuele instructies voor de inrichting.loans:read
POST/loans/spaces/{id}/bookBoek een kamer of ruimte voor een persoon en tijd, alleen of samen met apparatuur (alles of niets), met instructies voor de inrichting voor het team.loans:write
POST/loans/reservation-groups/{id}/partsVoeg één artikel, of één uit een categorie, toe aan een boeking van een set of winkelwagen, gecontroleerd als een nieuwe boeking. Geweigerd voor een vergrendelde set. Een onderdeel uit een categorie die het risicoformulier van de locatie dekt, vraagt om risk_answers, en de beoordeling van de boeking wacht op een nieuwe controle.loans:write
POST/loans/reservations/{id}/remove-partHaal één onderdeel uit een boeking van een set of winkelwagen; het laatste onderdeel wordt geannuleerd met de boeking.loans:write
GET/loans/placesDe eigen geneste plekken van de locatie: gebouwen, kamers, planken, bouwplaatsen en vrachtwagens. De place_id van een artikel bepaalt waar het staat en vult zijn location en sub_location.loans:read
GET/loans/category-treeDe categorieën apparatuur gegroepeerd in een boom, de bovenliggende eerst. Regels en boekingen gelden nog steeds voor de eigen categorie van een artikel.loans:read
GET/loans/asset-modelsModellen waarvan nieuwe artikelen worden gemaakt. Stuur asset_model_id mee bij POST /loans/items om elk leeggelaten detail in te vullen.loans:read
GET/loans/items/{id}/linksDe koppelingen van een artikel met andere artikelen van dezelfde locatie: werkt samen met, een alternatief, vervangt.loans:read
POST/loans/items/{id}/linksKoppel een artikel aan een ander van dezelfde locatie, met een notitie.loans:write
DELETE/loans/items/{id}/links/{link}Verwijder een koppeling bij beide artikelen.loans:write
POST/loans/kits/{id}/moveVerplaats een set naar een plek van de locatie: elk artikel met naam erin, en in de sets erin, gaat in één keer daarheen (eigenaren en managers).loans:write
GET/loans/items/{id}/meter-readingsMeterstanden die voor een artikel zijn ingevoerd, de nieuwste eerst.loans:read
POST/loans/items/{id}/meter-readingsLeg een meterstand vast. Een onderhoudsschema met every_meter is aan de beurt zodra de meter zo ver is gelopen; standen gaan alleen omhoog.loans:write
GET/loans/contractsContracten met leveranciers, gekoppeld aan de artikelen die ze dekken (eigenaren en managers).loans:read
GET/loans/resaleArtikelen die te koop staan, met hun vraagprijs en boekwaarde (eigenaren en managers). Alleen een lijst: er wordt niets geadverteerd of verkocht.loans:read
GET/loans/pointsOphaal- en inleverpunten die een boeking kan noemen.loans:read
POST/loans/pointsVoeg een punt toe (eigenaren en managers). Een boeking noemt er één om op te halen en één om in te leveren met pickup_point_id en dropoff_point_id.loans:write
PUT/loans/points/{id}Wijzig een punt of schakel het uit.loans:write
GET/loans/projectsProjecten waartoe een boeking kan behoren. Er wordt niets voor een project opgehaald totdat het is goedgekeurd.loans:read
POST/loans/projectsVoeg een project toe (wacht op goedkeuring).loans:write
POST/loans/projects/{id}/decisionKeur een project goed of af (eigenaren en managers).loans:write
GET/loans/risk-assessmentsRisicobeoordelingen die op een controle wachten (of op status), met de antwoorden van de persoon.loans:read
POST/loans/risk-assessments/{id}/reviewKeur een risicobeoordeling goed of af (eigenaren en managers). Bij een afwijzing wordt de boeking geannuleerd.loans:write
POST/loans/reservation-seriesBoek één artikel, één categorie of één kamer of ruimte elke dag of week (repeat: frequency, every, weekdays, count of until, skip_conflicts). Elke keer volgt de boekingsregels en telt de keren ervoor mee; er wordt niets geboekt als er één bezet is, tenzij skip_conflicts aan staat. Hoogstens 52 keer, binnen een jaar.loans:write
POST/loans/reservations/{id}/moveVerplaats een reservering, met elk onderdeel van een set of winkelwagen samen geboekt, naar nieuwe tijden of een ander artikel van dezelfde categorie. Opnieuw gecontroleerd als een nieuwe boeking; alles of niets.loans:write
GET/loans/waitlistMensen die wachten op een tijd die al bezet was, op status (standaard waiting).loans:read
POST/loans/waitlistZet iemand op de wachtlijst voor een artikel, een categorie of een ruimte en een tijd. Wanneer die vrijkomt, wordt de eerste persoon voor wie de tijd nu past geboekt en per e-mail op de hoogte gebracht.loans:write
POST/loans/waitlist/{id}/cancelHaal iemand van de wachtlijst.loans:write
GET/loans/feesHet grootboek van de kosten, de nieuwste eerst (filter op party_key, kind, status, billing_code, from, to), met de kosteninstellingen van de locatie en iedereen die iets verschuldigd is of een borg heeft staan. Bedragen zijn gehele getallen in de kleinste eenheid van de valuta. vFound registreert kosten; het verwerkt nooit een betaling.loans:read
GET/loans/fees/partyEén persoon (person_id of party_key): wat die verschuldigd is per valuta, borgen die worden vastgehouden, boekingen en facturen.loans:read
GET/loans/fees/billing-codesGerekend, kwijtgescholden, verrekend en nog verschuldigd per factureringscode en valuta voor een periode; format=csv voor een CSV.loans:read
POST/loans/fees/chargesLeg een vergoeding voor schade, vervanging of iets anders vast, of een kostenpost met een prijs via fee_template_id. De belasting van de locatie is van toepassing, tenzij taxable false is.loans:write
POST/loans/fees/paymentsLeg geld vast dat de locatie zelf heeft ontvangen (contant, het eigen pinapparaat, een overschrijving). Het verrekent openstaande bedragen, de oudste eerst.loans:write
POST/loans/fees/depositsLeg een borg vast die de locatie heeft ontvangen; vastgehouden totdat hij wordt teruggegeven of ingehouden.loans:write
POST/loans/fees/deposits/{id}/returnGeef een vastgehouden borg terug.loans:write
POST/loans/fees/deposits/{id}/keepHoud een vastgehouden borg of een deel ervan in (eigenaren en managers, met een reden); het ingehouden deel telt als betaling.loans:write
POST/loans/fees/{id}/waiveScheld af wat een bedrag nog nodig heeft (eigenaren en managers, met een reden).loans:write
POST/loans/fees/{id}/voidMaak een per ongeluk vastgelegde betaling ongeldig (eigenaren en managers, met een reden). Als je de betaling ongeldig maakt waarmee een borg is ingehouden, wordt dat bedrag weer als borg vastgehouden.loans:write
GET/loans/{id}/feesWat de balie wordt aangeboden voor een uitgifte die terug is: de boete voor te laat die nog niet is vastgelegd, de vervangingswaarde bij verlies of schade, vastgehouden borgen.loans:read
POST/loans/{id}/late-fineVoeg de boete voor te laat toe voor een uitgifte die te laat terugkwam, gerekend vanaf het moment van terugkomen. Eén keer per uitgifte.loans:write
GET/loans/invoicesFacturen, het nieuwste nummer eerst.loans:read
POST/loans/invoicesGeef een genummerde factuur uit voor de openstaande bedragen van een persoon in één valuta.loans:write
POST/loans/invoices/{id}/voidMaak een factuur ongeldig (eigenaren en managers, met een reden); met reissue komen de openstaande bedragen op een nieuwe die hem vervangt.loans:write
GET/loans/reservationsReserveringen op begintijd, optioneel gefilterd op status of from.loans:read
POST/loans/reservationsReserveer een specifiek artikel of één artikel in een categorie voor een persoon en tijdvak. custom_values stelt de eigen kenmerken van de locatie voor de boeking in.loans:write
POST/loans/reservations/{id}/approveKeur een reservering goed die op controle wacht. Als de locatie goedkeuringsstappen heeft, ondertekent een sleutel een stap alleen voor het teamlid dat in X-Acting-User staat, ondertekent een assistentverbinding er nooit een en ondertekent niemand een stap van een boeking die hij zelf heeft gemaakt (approval_not_yours). Boeken over een conflict heen volgt dezelfde regel.loans:write
POST/loans/reservations/{id}/cancelAnnuleer een reservering die in behandeling is, goedgekeurd is of klaarstaat.loans:write
POST/loans/reservations/{id}/pickupGeef het gereserveerde artikel atomair mee en sluit de reservering af als opgehaald.loans:write
POST/loans/reservation-groupsReserveer een set (kit_id) of een winkelwagen (items: per regel een artikel, of een categorie en aantal) voor één persoon en tijdvak: elk onderdeel of geen. Goedkeuren, annuleren of ophalen van een onderdeel geldt voor elk open onderdeel.loans:write
GET/loans/downtimesDatumperiodes waarin één artikel niet kan worden geboekt of uitgegeven en die nog niet zijn afgelopen (item_id beperkt tot één artikel).loans:read
POST/loans/downtimesVoeg een periode toe aan een artikel: loan_item_id, starts_at, ends_at en een optionele reason. Geweigerd zolang een boeking of uitgifte het artikel voor een deel van die tijd vasthoudt.loans:write
DELETE/loans/downtimes/{id}Verwijder een periode.loans:write
GET/loans/extra-values/{type}/{id}De eigen kenmerken van de locatie voor een persoon (person), een reservation of een checkout, met de velden die voor dat soort dossier zijn gedefinieerd.loans:read
PUT/loans/extra-values/{type}/{id}Stel die kenmerken in, gecontroleerd aan de hand van de velden van de locatie en hun voorwaarden voor tonen.loans:write
GET/loans/closuresDagen dat de balie voor apparatuur gesloten is en die nog niet zijn afgelopen.loans:read
POST/loans/closuresVoeg een sluiting toe: starts_on en ends_on als datums in de tijdzone van de locatie, tot 366 dagen. Een optionele note blijft intern; public_message (tot 300 tekens) wordt aan mensen getoond. Bestaande notities worden nooit gekopieerd naar het bericht voor mensen.loans:write
DELETE/loans/closures/{id}Verwijder een sluiting.loans:write
GET/loans/rulesStandaardwaarden van de locatie, categorieregels voor duur, limieten, blokkades bij te laat, goedkeuring en boekingsregels (buffers tussen boekingen, minimale vooraankondiging, hoe ver vooruit) en sluitingen.loans:read
POST/loans/rulesMaak één categorieregel aan of vervang hem. Weggelaten velden van boekingsregels behouden hun opgeslagen waarden.loans:write
GET/loans/timelineControles van de capaciteit van artikelen of categorieën per hele dag. Verplichte from- en until-data, inclusief, in lokale tijd van de locatie, hoogstens 31 dagen vanaf vandaag tot en met volgend jaar; optioneel group=item|category, item_id, exacte category, page (50 rijen). Cellen zijn true, false of null (onzeker). Aangrenzende dagen garanderen geen ononderbroken boeking.loans:read
GET/loans/warrantiesVastgelegde garantiedata; filter=soon|expired|all, exacte category, page (50 rijen). Soon omvat vandaag tot 30 dagen vooruit. Een persoonlijke aanmelding voor herinneringen staat in de werkruimte.loans:read
GET/loans/utilizationVerstreken uren per object op basis van de vastgelegde statusgeschiedenis. Verplichte from- en until-data, inclusief, in lokale tijd van de locatie, binnen de laatste 365 dagen en begrensd op nu; optioneel item_id, exacte category, format=csv. JSON geeft exacte seconden; uren in CSV hebben zes decimalen. Beschikbaar omvat uitgegeven tijd; tijd voor reparatie of service en andere onbeschikbare tijd worden niet meegeteld. Eerdere stilstand is onbekend. De totalen sluiten aan op de rijen per object.loans:read
GET/loans/maintenanceDe geschiedenis van service, kalibratie, veiligheidstest, inspectie, schoonmaak, reparatie en notities; filter op artikel, aankomend werk of werkopdrachten (open of alle) en hun technicus.loans:read
POST/loans/maintenanceLeg onderhoud en de volgende keer dat het aan de beurt is vast voor een artikel. Met plan_id het werk dat is gedaan voor een terugkerend schema, dat zijn volgende ronde start.loans:write
GET/loans/service-plansTerugkerende schema's voor service, kalibratie, veiligheidstest, inspectie en schoonmaak, met of elk aan de beurt is op datum, aantal uren uitgegeven of aantal uitgiftes.loans:read
POST/loans/service-plansVoeg een terugkerend schema toe aan een artikel (eigenaren en managers).loans:write
PUT/loans/maintenance/{id}Wijzig een werkopdracht of sluit hem af: status, technicus, leverancier, kosten, en bij done het resultaat en of het artikel weer in gebruik gaat.loans:write
GET/loans/maintenance/costsKosten van service, reparatie en schoonmaak per artikel, uit afgeronde regels en afgeronde werkopdrachten.loans:read
GET/loans/items/{id}/lifecycleHet dossier van aankoop, afschrijving, verzekering en afstoting van een artikel, met zijn waarde van vandaag (eigenaren en managers).loans:read
PUT/loans/items/{id}/lifecycleSla de aankoopprijs, datum, leverancier en bestelling op, de afschrijvingsmethode (lineair of degressief), levensduur en restwaarde, en de verzekering (eigenaren en managers).loans:write
POST/loans/items/{id}/disposeLeg vast hoe een artikel is vertrokken (verkocht, afgevoerd, geschonken, gerecycled, verloren of gestolen); het wordt buiten gebruik gesteld en zijn open boekingen en werkopdrachten worden geannuleerd.loans:write
DELETE/loans/items/{id}/disposeMaak een per ongeluk gedane afstoting ongedaan; het artikel is weer beschikbaar.loans:write
GET/loans/valuationDe waarde van de apparatuur op een datum, tot op de cent, met totalen voor wat nog wordt aangehouden (eigenaren en managers).loans:read
POST/loans/service-plans/importControleer of voeg schema's toe vanuit een CSV met de gedocumenteerde kolommen, met apparatuur die bij inventarislabel wordt genoemd (eigenaren en managers).loans:write
POST/loans/maintenance/work-orders/importControleer of voeg open werkopdrachten toe vanuit een CSV met de gedocumenteerde kolommen (eigenaren en managers).loans:write
GET/loans/maintenance/plannerGepland werk en open werkopdrachten per eigen dag van de locatie voor maximaal 62 dagen, optioneel voor één technicus.loans:read
GET/loans/fundingWat elk fonds, elke subsidie of kostenplaats heeft gekocht en welk werk eraan is toegerekend, te filteren op fonds en data (eigenaren en managers). Alleen een registratie: vFound neemt geen betaling aan.loans:read
GET/loans/substancesHet register van gevaarlijke stoffen: stof, plek, gevarenklassen en data van beoordeling. Een registratie van wat de locatie zegt; vFound geeft geen veiligheidsadvies.loans:read
POST/loans/substancesVoeg een stof toe, met zijn veiligheidsinformatieblad als PDF of foto (eigenaren en managers).loans:write
PUT/loans/substances/{id}Wijzig een stof of vervang zijn informatieblad (eigenaren en managers).loans:write
DELETE/loans/substances/{id}Verwijder een stof en zijn bewaarde informatieblad (eigenaren en managers).loans:write
GET/loans/licencesLicenties voor de apparatuur van de locatie met aantal gebruikers, einddatum en de artikelen waarop ze zijn geïnstalleerd (eigenaren en managers). Er wordt geen licentiesleutel opgeslagen.loans:read
POST/loans/licencesVoeg een licentie toe (eigenaren en managers).loans:write
PUT/loans/licences/{id}Wijzig een licentie en waar die is geïnstalleerd.loans:write
DELETE/loans/licences/{id}Verwijder een licentie.loans:write
GET/loans/expiriesVerzekeringen en licenties die binnenkort aflopen of al zijn afgelopen (eigenaren en managers).loans:read
GET/loans/stocktakesRecente inventarisaties van apparatuur met aantallen gescand en ontbrekend.loans:read
POST/loans/stocktakesStart één open inventarisatie voor de locatie, voor alles, voor één plek, categorie of set, of voor wat één persoon heeft (custodian_id), optioneel toegewezen aan een teamlid (assigned_to).loans:write
POST/loans/stocktakes/{id}/scanScan een label van apparatuur, een inventarislabel of een serienummer in de open inventarisatie.loans:write
POST/loans/stocktakes/{id}/scan-manyTel tot 2,000 codes tegelijk (een RFID-lezer die als toetsenbord typt, of een lijst); elke code telt één keer en codes zonder match komen terug.loans:write
PUT/loans/stocktakes/{id}/assignGeef de open inventarisatie aan één teamlid om te tellen (assigned_to), of aan niemand (null).loans:write
POST/loans/stocktakes/{id}/finishRond de inventarisatie af en geef de lijst met ontbrekende artikelen terug.loans:write
GET/loans/stocktake-schedulesInventarisaties die vanzelf openen, eenmalig of terugkerend.loans:read
POST/loans/stocktake-schedulesPlan een inventarisatie, eenmalig, wekelijks, maandelijks, elke drie maanden of jaarlijks, op de eigen tijd van de dag van de locatie.loans:write
PATCH/loans/stocktake-schedules/{id}Wijzig, pauzeer of hervat een schema.loans:write
DELETE/loans/stocktake-schedules/{id}Verwijder een schema; inventarisaties die het heeft geopend blijven bestaan.loans:write
GET/loans/last-seenWaar elk artikel voor het laatst is gescand, wanneer de locatie scanposities bewaart (alleen teamleden die hebben ingestemd; nooit vanuit een sleutel).loans:read
GET/loans/transfersBinnenkomende en uitgaande verplaatsingen van apparatuur voor deze locatie.loans:read
POST/loans/transfersMaak apparatuur klaar voor een andere bevoegde locatie in dezelfde klantgroep.loans:write
POST/loans/transfers/{id}/sendLeg vast dat klaargemaakte apparatuur de bronlocatie heeft verlaten.loans:write
POST/loans/transfers/{id}/receiveOntvang apparatuur op de bestemming, met de plek en de staat bij aankomst.loans:write
POST/loans/transfers/{id}/cancelAnnuleer een klaargemaakte verplaatsing voordat die wordt verzonden.loans:write
POST/loans/transfers/{id}/rejectWijs een klaargemaakte verplaatsing op de bestemming af voordat die wordt verzonden.loans:write
POST/loans/transfers/{id}/exceptionLeg een probleem vast terwijl apparatuur onderweg is.loans:write
POST/loans/importBekijk een voorbeeld van of importeer tot 5,000 CSV-rijen met kopteksten van vFound, Snipe-IT, Sortly of Cheqroom.loans:write

Visitors

VerzoekWat het doetScope
GET/visitorsBezoeken, de laatst gewijzigde eerst, met status (expected, in, out, cancelled of missed), de bezoeker, de gastheer, de passcode zolang die geldig is, en de tijden. Filters: status, search (bezoeker, bedrijf, gastheer of passcode), updated_since.visitors:read
GET/visitors/{id}Eén bezoek.visitors:read
POST/visitorsNodig een bezoeker uit of meld er een aan. Het accepteert de velden voor bezoeker, gastheer en tijd, plus visitor_type_id, antwoorden, geldige data en een terugkeerpatroon per dag of op werkdagen.visitors:write
POST/visitors/{id}/sign-inMeld een verwachte bezoeker aan; de gastheer wordt op de hoogte gebracht. Stuur answers mee voor een groepslid van wie het type verplichte vragen heeft, en id_expires_on met identity_checked wanneer de locatie de vervaldatum van een fysiek ID vastlegt. Het bezoek bevat dan id_expires_on en id_expired.visitors:write
POST/visitors/{id}/group/sign-inMeld iedereen in de groep van het bezoek aan die vandaag wordt verwacht, met één e-mail aan de gastheer; wie een eigen foto, ID-controle, handtekening, antwoorden of voorwaarden nodig heeft, staat vermeld in skipped.visitors:write
POST/visitors/{id}/sign-outMeld ze af.visitors:write
POST/visitors/{id}/cancelAnnuleer een uitnodiging.visitors:write
POST/visitors/{id}/send-passStuur de pas opnieuw per e-mail.visitors:write
POST/visitors/{id}/approveKeur een bezoek goed dat in behandeling is en stuur de pas.visitors:write
POST/visitors/{id}/denyWijs een bezoek af dat in behandeling is.visitors:write
GET/visitors/{id}/badgeDownload de badge die in de browser kan worden afgedrukt. Kies size 4x3, brother of dymo.visitors:read
GET/visitors/{id}/cardOf het bezoek een RFID-kaart heeft en de laatste vier tekens ervan (nooit het nummer). Uit totdat de locatie Kaarten en sleutelhangers inschakelt.visitors:read
POST/visitors/{id}/cardGeef een verwacht of aangemeld bezoek een kaart via het nummer ervan; één nummer is tegelijk bij één bezoek actief.visitors:write
DELETE/visitors/{id}/cardNeem de kaart terug.visitors:write
GET/visitors/{id}/assetsDe dingen die aan het bezoek zijn meegegeven, met de hand ingevoerd.visitors:read
POST/visitors/{id}/assetsLeg een ding vast dat aan het bezoek is meegegeven, met een optionele tag.visitors:write
POST/visitors/{id}/assets/{asset}/returnMarkeer een ding als teruggebracht.visitors:write
GET/visitor-assets/not-returnedDingen die aan bezoekers zijn meegegeven en nog niet zijn teruggebracht, de nieuwste eerst.visitors:read
GET/visitors/{id}/fast-trackOf het bezoek een actieve fast-trackcode heeft, tot wanneer en hoe vaak die is gebruikt (nooit de code zelf, die alleen de bezoeker ziet).visitors:read
POST/visitors/{id}/fast-trackGeef een terugkerende bezoeker een fast-trackcode die days (1 tot 365) geldig is.visitors:write
DELETE/visitors/{id}/fast-trackNeem de code terug.visitors:write
GET/visitor-typesToon bezoekerstypen en hun vragen, voorwaarden, badges, goedkeuringen en bewaartermijn (retention_days is null wanneer het type de standaardinstelling van de locatie volgt).visitors:read
POST/visitor-typesMaak een bezoekerstype aan.visitors:write
PATCH/visitor-types/{id}Wijzig de velden van het bezoekerstype die je meestuurt.visitors:write
DELETE/visitor-types/{id}Deactiveer een bezoekerstype zonder eerdere bezoeken te wijzigen.visitors:write
GET/visitor-roll-callHaal het laatste appèl op, met de live tellingen. Een lopend appèl voegt iedereen toe die zich heeft aangemeld sinds het begon; een appèl dat 6 uur blijft lopen, wordt gesloten.visitors:read
POST/visitor-roll-callStart een appèl, optioneel met bezoekers die vandaag worden verwacht en iedereen die op goedkeuring wacht.visitors:write
PATCH/visitor-roll-call/entries/{entry}Markeer één regel als veilig of vermist.visitors:write
POST/visitor-roll-call/{id}/finishRond het actieve appèl af en bewaar het rapport.visitors:write
GET/staff-attendanceToon de aanwezigheid van medewerkers voor een datumbereik op de klok van de locatie (standaard vandaag, hoogstens 366 dagen), of alleen mensen die nu zijn aangemeld met open=true. Bevat nooit het e-mailadres van de persoon.visitors:read
POST/staff-attendanceMeld een persoon op de medewerkerslijst aan (mode office of remote) of af, met dezelfde regels als de balie. Vereist dat aanmelden voor medewerkers op de locatie is ingeschakeld.visitors:write
POST/staff-presenceStuur tot 50 aanwezigheidsgebeurtenissen (in, out of muster) vanuit je badge-, prikklok- of wifisysteem, elk met een persoon op de medewerkerslijst, genoemd via referentie, extern ID of e-mailadres. Vereist dat aanmelden voor medewerkers en de aanwezigheidsfeed op de locatie zijn ingeschakeld. Antwoordt wat er per gebeurtenis gebeurde, nooit wie.visitors:write
POST/visitors/{id}/cateringMaak, wijzig of (zonder artikelen) verwijder het cateringverzoek van een verwacht of aangemeld bezoek, uit de opties die de locatie opgeeft. Stuurt één e-mail naar de cateringpostbus van de locatie; vFound bestelt niets en neemt geen betaling aan. Vereist dat catering op de locatie is ingeschakeld.visitors:write
GET/workplace/spacesToon de werkplekken, vergaderruimtes en parkeerplaatsen die mensen op de locatie mogen boeken.visitors:read
GET/workplace/freeZoek ruimtes die vrij zijn voor een hele tijd (hoogstens 7 dagen), met uitzondering van een werkplek die voor een andere persoon wordt vrijgehouden.visitors:read
GET/workplace/bookingsToon boekingen van werkplekken, kamers en parkeerplaatsen in een periode van hoogstens 31 dagen. Bevat nooit het e-mailadres van de persoon.visitors:read
POST/workplace/bookingsBoek een ruimte voor een persoon, eenmalig of als terugkerende boeking (dagelijks of wekelijks, tot 52 keer, alles of niets), volgens de reserveringsregels van Equipment.visitors:write
POST/workplace/bookings/{id}/cancelAnnuleer een boeking, of met scope following of series de latere tijden ervan.visitors:write
POST/workplace/bookings/{id}/check-inCheck een boeking in, vanaf 15 minuten voordat die begint totdat die eindigt.visitors:write
POST/visitors/{id}/roomBoek een vergaderruimte voor een bezoek, vanaf de tijd van het bezoek; de ruimte volgt het bezoek.visitors:write
GET/appointment-pagesToon de afsprakenpagina's van de locatie, hun uren en of elke nu openstaat voor bezoekers.visitors:read
GET/visitor-roll-call/archiveToon afgesloten appèls (noodgevallen, oefeningen en mededelingen), de nieuwste eerst.visitors:read
GET/visitor-roll-call/{id}Eén appèl met zijn mensen, tijdlijn, controlerondes en aantallen berichten.visitors:read
POST/visitor-roll-call/{id}/peopleVoeg een persoon (een medewerker, anders of een aannemer) toe aan het lopende appèl.visitors:write
POST/visitor-roll-call/{id}/scanMarkeer een bezoeker als veilig via zijn passlink of code, bij een verzamelpunt.visitors:write
POST/visitor-roll-call/{id}/sweepsLeg vast dat een zone is gecontroleerd en leeg is, of dat er mensen in zijn.visitors:write
POST/visitor-roll-call/{id}/messagesStuur een bericht naar iedereen, naar mensen die nog niet veilig zijn of naar mensen die hulp nodig hebben. Het gaat per e-mail, browsermelding en, via de eigen aanbieder van de locatie, sms of WhatsApp, met een privélink om te antwoorden dat ze veilig zijn of hulp nodig hebben.visitors:write
GET/visitor-roll-call/{id}/people/{entry}/messagesHet gesprek met één persoon in een appèl: wat het team hun stuurde en wat ze terugschreven via hun privélink, de oudste eerst. Schrijf terug met het berichten-endpoint en audience entry.visitors:read
POST/visitor-hazard-alertsEen waarschuwing die een teamlid schrijft en naar een gekozen groep stuurt: hazard, message en group (on_site, visitor_type, host of tenant, met group_ref). Het start een appèl van het soort hazard voor die groep. vFound leest geen weer-, nieuws- of dreigingsfeed: er wordt niets verstuurd tenzij jij dit verzoek stuurt. Antwoordt 409 zolang een ander appèl loopt.visitors:write
POST/visitor-help-alertsVraag stilletjes om hulp: de teamleden die daarvoor zijn gekozen worden op de hoogte gebracht; geen enkele bezoeker ziet iets.visitors:write
GET/visitor-kiosksToon gekoppelde, wachtende en ingetrokken kioskapparaten.visitors:read
POST/visitor-kiosks/pairingMaak een koppelcode van acht tekens aan die tien minuten geldig is.visitors:write
DELETE/visitor-kiosks/{id}Trek een kioskapparaat in.visitors:write
PUT/visitor-kiosks/{id}/settingsWijzig de instellingen van één kiosk: een e-mail wanneer hij een aantal minuten niet is gezien, terug naar het begin na een rustige periode, een handtekening bij het aanmelden en het afdrukken van de badge vanaf de tablet. Alles staat standaard uit.visitors:write
GET/visitor-analyticsTotalen per dag, uur, type en gastheer, plus de gemiddelde verblijfsduur over het afgelopen jaar.visitors:read
GET/visitor-registrationHaal de zelfregistratielink van de locatie op en of die is ingeschakeld.visitors:read
GET/school/movementsTe late aankomsten en vroeg vertrek van leerlingen, de oudste eerst, vanaf since (standaard de laatste 24 uur), met de reference van elke leerling voor het schoolinformatiesysteem. Een teamlid met alleen kijkrechten dat in X-Acting-User wordt genoemd, kan dit niet gebruiken.school:read
PUT/school/pupilsVoeg tot 500 leerlingen toe of werk ze bij via reference; stuur active false voor een leerling die is vertrokken. Hier wordt niets verwijderd.school:write

De gegevens van bezoekers zijn persoonsgegevens: bewaar ze alleen zolang je ze nodig hebt.

Personen

De personenlijst bevat de bewoners, medewerkers of studenten die je balie bedient. Parcels zoekt ontvangers erin, Visitors zoekt gastheren en Equipment stelt personen voor. Houd hem via de API gelijk met je HR-, studenten- of accommodatiesysteem.

VerzoekWat het doetScope
GET/peopleDe lijst, op naam. Filters: search (naam, e-mailadres, unit of referentie), updated_since.people:read
GET/people/{id}Eén persoon.people:read
POST/peopleVoeg iemand toe: name (verplicht), email, unit, reference en language voor hun e-mails.people:write
POST/people/upsertVoeg tot 500 mensen toe of werk ze bij in één aanroep: people is een lijst met dezelfde velden. Iemand van wie het e-mailadres al op de lijst staat, wordt bijgewerkt. Antwoordt hoeveel er zijn toegevoegd, bijgewerkt en overgeslagen.people:write
PATCH/people/{id}Wijzig alleen de velden die je meestuurt.people:write
DELETE/people/{id}Verwijder iemand. Hun pakketten, bezoeken en uitgiftes behouden de naam die ze hadden.people:write
GET/people/exportDownload de volledige personenlijst als CSV die veilig is voor formules.people:read
POST/people/{id}/send-my-vfoundStuur één actieve persoon per e-mail de ondertekende pagina voor hun gekoppelde pakketten, bezoekers en apparatuur.people:write
GET/people/sync-sourceToon de opgeslagen CSV-directory en het laatste synchronisatieresultaat.people:read
PUT/people/sync-sourceSla een openbare HTTPS-CSV-url en mode (upsert of mirror) op.people:write
DELETE/people/sync-sourceVerwijder de koppeling en behoud de mensen die al zijn geïmporteerd.people:write
POST/people/sync-source/runVoer de opgeslagen koppeling nu uit.people:write

Eigenaren en managers kunnen ook een openbare HTTPS-CSV-link koppelen via Personen. vFound controleert hem elk uur, volgt hoogstens drie omleidingen nadat elke bestemming is gecontroleerd, accepteert hoogstens 10 MB en stopt in mirror-modus voordat het wijzigingen doorvoert wanneer het aantal geldige rijen met meer dan 30 procent daalt. Gekoppelde velden worden bij hun bron gewijzigd.

Automatische inrichting vanuit een directory

Microsoft Entra heeft de hierboven beschreven kant-en-klare koppeling die de klant zelf instelt. Identiteitsdirectory's, waaronder Okta, OneLogin en JumpCloud, kunnen in plaats daarvan de personenlijst inrichten op https://vfound.io/api/scim/v2/Users met een vFound API-sleutel die people:write heeft. Gebruik de Bearer-sleutel als het geheime token. Deactiveren haalt de persoon uit de suggesties; DELETE anonimiseert koppelingen volgens dezelfde regels voor Personen. Dit endpoint maakt alleen items in de personenlijst aan en nooit teamlogins.

Trainingsregisters voor Equipment kunnen uit dezelfde directory komen: koppel een training via de naam aan een directorygroep (Equipment, Beleid, Training) en wijs die groep dan toe aan de vFound-applicatie. https://vfound.io/api/scim/v2/Groups antwoordt alleen voor groepen die een training noemt en weigert elke andere groep. De leden zijn de mensen (via hun SCIM-gebruikers-id) die de training hebben; een persoon die de groep verlaat, verliest de training alleen als de directory die heeft gegeven, dus een dossier dat medewerkers hebben toegevoegd blijft. Een dossier dat de directory heeft gegeven en dat is verlopen, wordt vanaf die dag verlengd wanneer de directory de groep opnieuw stuurt met de persoon er nog in. Groepen antwoorden alleen voor een locatie met Equipment. Omdat groepslidmaatschap een training geeft, en een training mensen de apparatuur laat meenemen waarvoor die nodig is, kan een sleutel met people:write op deze manier trainingen toekennen: houd die sleutel voor je identiteitsprovider.

Webhooks

Voeg tot 25 HTTPS-adressen toe onder Instellingen, Voor ontwikkelaars, of via de API hieronder, en kies welke van de onderstaande gebeurtenissen elk adres ontvangt. vFound stuurt binnen enkele seconden een JSON-POST, probeert mislukte leveringen ongeveer drie uur opnieuw en pauzeert een adres na 15 mislukte leveringen achter elkaar.

GebeurtenisWanneerGegevens
item.createdEr wordt een gevonden voorwerp toegevoegdVoorwerp
item.updatedDe status, titel, plek, categorie, bewaardatum of zichtbaarheid van de foto verandertVoorwerp
item.transfer_sentEen gevonden voorwerp wordt naar een andere locatie van de groep gestuurd (beide locaties ontvangen dit)Verplaatsing van voorwerp
item.transfer_cancelledDe verzendende locatie neemt het terug voordat het aankomtVerplaatsing van voorwerp
item.transfer_receivedDe ontvangende locatie bevestigt dat het is aangekomenVerplaatsing van voorwerp
claim.createdEen gast dient een claim inClaim
item.disposition_recordedEen voorwerp wordt geschonken of afgevoerdVoorwerp
item.match_updatedEen opgeslagen AI-oordeel over een match verandert; report_id, item_id, label en reasonMatchpaar
lost_report.match_updatedEen opgeslagen AI-oordeel over een match verandert; report_id, item_id, label en reasonMatchpaar
claim.ownership_reviewedEen manager legt een beoordeling van eigendom vast; haal de bewaargeschiedenis op voor de geschiedenis van de beoordelingClaim
claim.decision_recordedEen claim wordt geaccepteerd of afgewezenClaim
claim.release_approvedEen andere manager keurt de vrijgave goedClaim
claim.handover_recordedHet fysiek ophalen sluit een claim af die klaarstaat om opgehaald te wordenClaim
claim.status_changedEen claim gaat naar een nieuwe statusClaim
lost_report.updated, lost_report.closed, lost_report.contact_updated, lost_report.createdEen gast meldt een verliesVerliesmelding
parcel.loggedEen pakket wordt aan de balie of via de API geregistreerdPakket
parcel.updatedEen van de gegevens ervan verandert aan de balie, zoals de ontvanger, het trackingnummer of de plankPakket
parcel.remindedDe ontvanger krijgt een herinnering, van de balie of automatischPakket
parcel.collectedEen pakket wordt overhandigdPakket
parcel.returnedEen pakket gaat terug naar de afzenderPakket
parcel.recipient_arrivedEen ontvanger zegt dat hij bij de balie isRegel in de ophaalwachtrij
parcel.reminders_snoozedEen ontvanger pauzeert zijn herinneringenPersoon en aantal pakketten
parcel.heldEen ontvanger stelt een datum voor het vasthouden inPersoon, datum en aantal pakketten
parcel.proxy_createdEen ontvanger mailt een gemachtigde een ophaalcodePersoon, gemachtigde en vervaldatum
parcel.pickup_servedDe balie markeert een aankomst als geholpenRegel in de ophaalwachtrij
parcel.escalatedEen wachtend pakket bereikt de escalatieleeftijd van de locatiePakket
parcel.outgoing_loggedEen uitgaand pakket wordt geregistreerdUitgaand pakket
parcel.outgoing_handed_overEen uitgaand pakket wordt aan een koerier overgedragenOverdracht van uitgaand pakket
parcel.round_createdEen bezorgronde wordt aangemaaktSamenvatting van de ronde
parcel.round_deliveredEen stop van een bezorgronde is afgerondId's van ronde, stop en pakket
checkroom.checked_inEr wordt iets ingecheckt en van een nummer voorzienTicket
checkroom.handed_backHet wordt teruggegevenTicket
checkroom.leftDe avond wordt gesloten terwijl het nog bij de checkroom ligtTicket
checkroom.self_checkin_startedEen gast start een ticket via een gekoppelde kioskTicket
checkroom.ready_requestedEen gast vraagt de balie zijn spullen klaar te zettenTicket
checkroom.readyDe balie markeert de spullen van een gast als klaarTicket
checkroom.station_createdEr wordt een checkroompost aangemaaktPost
checkroom.station_updatedEen checkroompost verandertPost
checkroom.event_createdEr wordt een checkroomevenement aangemaaktGebeurtenis
checkroom.event_updatedEen checkroomevenement verandertGebeurtenis
loan.checked_outEr wordt een artikel uitgegevenUitgifte
loan.due_soonDe inlevertijd is minder dan twee uur weg, één keer per inlevertijdUitgifte
loan.overdueDe inlevertijd verstrijkt en het is niet terug, één keer per inlevertijdUitgifte
loan.extendedDe inlevertijd verandertUitgifte
loan.returnedHet komt terug bij de balieUitgifte
loan.lostHet wordt vastgelegd als niet terugkomendUitgifte
loan.checkout_createdEr wordt één atomaire uitgifte van meerdere artikelen aangemaaktUitgifte, met eventuele voorraad op dezelfde bon in stock
loan.self_checkoutEen persoon rondt de uitgifte aan de kiosk afUitgifte
loan.kit_createdEr wordt een opgeslagen set apparatuur aangemaaktSet
loan.kit_updatedEen opgeslagen set apparatuur verandertSet
loan.reservation_requestedEen reservering wacht op goedkeuringReservering
loan.reservation_createdEen reservering wordt direct bevestigdReservering
loan.reservation_approvedEen reservering in behandeling wordt goedgekeurdReservering
loan.reservation_readyGereserveerde apparatuur staat klaar om opgehaald te wordenReservering
loan.reservation_cancelledEen reservering wordt geannuleerdReservering
loan.reservation_collectedGereserveerde apparatuur wordt meegegevenUitgifte
loan.extension_requestedIemand vraagt om meer tijdUitgifte
loan.problem_reportedIemand meldt een probleem met apparatuurUitgifte
loan.rule_updatedEen uitgifteregel voor een categorie verandertRegel
loan.maintenance_loggedEr wordt onderhoud vastgelegdOnderhoud
loan.maintenance_dueGepland onderhoud is aan de beurtOnderhoud
loan.service_dueEen terugkerend serviceschema is aan de beurt (op datum, aantal uren uitgegeven of aantal uitgiftes), één keer per rondeOnderhoud
loan.work_order_openedEr wordt een werkopdracht geopend, door medewerkers of door een terugkeer waarvoor de locatie vraagt er een te openenOnderhoud
loan.work_order_closedEen werkopdracht is afgerond of geannuleerdOnderhoud
loan.item_disposedEen artikel wordt afgestoten (verkocht, afgevoerd, geschonken, gerecycled, verloren of gestolen)Equipment
loan.stocktake_startedEen inventarisatie van apparatuur startInventarisatie
loan.stocktake_completedEen inventarisatie van apparatuur eindigtInventarisatie
loan.transfer_preparedEen bevoegde locatie maakt apparatuur klaar om te verplaatsenVerplaatsing
loan.transfer_sentKlaargemaakte apparatuur verlaat zijn bronlocatieVerplaatsing
loan.transfer_receivedDe bestemming ontvangt de apparatuurVerplaatsing
loan.transfer_rejectedDe bestemming wijst een klaargemaakte verplaatsing afVerplaatsing
loan.transfer_cancelledDe bron annuleert een klaargemaakte verplaatsingVerplaatsing
loan.transfer_exceptionEen verplaatsing onderweg heeft aandacht nodigVerplaatsing
loan.transfer_lostDe bron sluit een verplaatsing af die nooit is aangekomenVerplaatsing
loan.charge_recordedEr wordt een boete, schade, vervanging, gebruik of andere vergoeding vastgelegdKostenregel
loan.charge_waivedEen manager scheldt af wat een bedrag nog nodig heeft, met een redenKostenregel
loan.payment_recordedMedewerkers leggen geld vast dat de locatie zelf heeft ontvangen (vFound verwerkt nooit een betaling)Kostenregel
loan.payment_voidedEen manager maakt een per ongeluk vastgelegde betaling ongeldigKostenregel
loan.deposit_recordedMedewerkers leggen een borg vast die de locatie heeft ontvangenKostenregel
loan.deposit_resolvedEen vastgehouden borg wordt teruggegeven of ingehoudenKostenregel
loan.invoice_issuedEr wordt een factuur uitgegeven voor de bedragen van een persoonFactuur
loan.invoice_voidedEen manager maakt een factuur ongeldig, met een redenFactuur
loan.quote_acceptedHet team accepteert een offerte en de bijbehorende boekingen worden gemaaktOfferte
loan.payment_request_createdHet team legt een betalingsverzoek vast (er wordt niets naar de persoon gestuurd)Betalingsverzoek
loan.payment_request_paidBetalingen die bij een verzoek zijn vastgelegd, dekken het volledigBetalingsverzoek
loan.delivery_doneEen bezorging of een ophaalmoment is als gedaan gemarkeerdBezorging
loan.items_importedEen CSV-import van apparatuur is voltooidAantallen
visit.expectedEen bezoeker wordt uitgenodigdBezoek
visit.signed_inEen bezoeker meldt zich aan, aan de balie of via je QR-bordBezoek
visit.host_confirmedDe balie bevestigt wie een bezoeker die zichzelf aanmeldde kwam bezoekenBezoek
visit.signed_outZe melden zich af, aan de balie, met hun pas of automatisch nadat de dag is afgelopenBezoek
visit.cancelledEen uitnodiging wordt geannuleerdBezoek
visit.approval_requestedEen bezoek wacht op goedkeuring door medewerkersBezoek
visit.approvedEen bezoek in behandeling wordt goedgekeurdBezoek
visit.deniedEen bezoek in behandeling wordt afgewezenBezoek
visit.host_repliedEen gastheer antwoordt via zijn privélinkBezoek
visit.roll_call_startedEen live appèl (een noodgeval, een oefening of een mededeling) startSamenvatting van het appèl
visit.roll_call_completedEen live appèl eindigtSamenvatting van het appèl
visitor_type.createdEr wordt een bezoekerstype aangemaaktBezoekerstype
visitor_type.updatedEen bezoekerstype verandertBezoekerstype
visitor_type.deactivatedEen bezoekerstype wordt gedeactiveerdBezoekerstype
visitor_agreement.signedEen bezoeker heeft een overeenkomst ondertekend, met een link naar het ondertekende exemplaar die zeven dagen werktOndertekening van overeenkomst
kiosk.pairedEen bezoekerskiosk wordt gekoppeldKiosk
kiosk.revokedEen bezoekerskiosk wordt ingetrokkenKiosk
courier.signed_inEen bezoeker die iets bezorgt, wordt geregistreerd in ParcelsKoerier
courier.signed_outEen bezoeker die iets bezorgt, vertrektKoerier
staff.signed_inEen persoon op de medewerkerslijst meldt zich aan, op kantoor of op afstandAanwezigheid van medewerkers
staff.signed_outEen persoon op de medewerkerslijst meldt zich af, of wordt automatisch afgemeldAanwezigheid van medewerkers
person.createdEr wordt een persoon toegevoegdPersoon
person.updatedEen persoon wordt gewijzigdPersoon
person.deactivatedInrichting vanuit een directory deactiveert een persoonPersoon
person.deletedEen persoon wordt verwijderdPersoon
people.sync.completedEen gekoppelde CSV-synchronisatie is voltooidAantallen
people.sync.failedEen gekoppelde CSV-synchronisatie mislukt veiligFout
report.deliveredEen geplande rapportage uit Rapporten en analyses, gedeeld met de locatie, wordt uitgevoerd met levering aan gekozen webhooks (een privérapport wordt nooit naar webhooks gestuurd); meld je erop aan in Instellingen, Voor ontwikkelaars (een API-sleutel kan zich er niet op aanmelden)Elke kolom die het rapport noemt en tot 5,000 rijen, of elke groep
queue.ticket_joinedEen persoon sluit aan in een rij, vanaf zijn telefoon, een kiosk, de balie of de APIQueue-ticket
queue.ticket_calledEen persoon wordt naar een balie geroepen, of opnieuw geroepenQueue-ticket
queue.ticket_servedEen persoon wordt als geholpen gemarkeerdQueue-ticket
queue.ticket_no_showEen opgeroepen persoon wordt als no-show gemarkeerd, door het team of na de minuten van de rijQueue-ticket
queue.ticket_leftEen persoon verlaat de rij vanaf zijn ticket, of het team haalt hem eruitQueue-ticket
queue.ticket_transferredEen persoon wordt naar een andere rij of balie verplaatstQueue-ticket
queue.ticket_closedEen ticket dat aan het einde van de dag van de locatie nog open is, of in een gearchiveerde rij, wordt geslotenQueue-ticket
queue.booking_createdEen persoon reserveert een tijd op de pagina met gereserveerde tijden van een rij, of de API doet datQueue-reservering
queue.booking_cancelledEen gereserveerde tijd wordt geannuleerd door de persoon, het team of de APIQueue-reservering
queue.ticket_arrivedEen persoon die aansloot voordat hij er was, zegt dat hij er is, of het team markeert hem als aangekomenQueue-ticket
queue.message_receivedEen persoon in de rij schrijft het team vanaf zijn ticketpagina; de gebeurtenis bevat geen tekstQueue-bericht
queue.message_sentHet team schrijft een persoon in de rij; de gebeurtenis bevat geen tekstQueue-bericht
queue.survey_answeredEen geholpen persoon beantwoordt de enquête; de gebeurtenis bevat de beoordeling en nooit de opmerkingAntwoord op de Queue-enquête
{"id":"evt_…","type":"claim.created","created":"2026-09-23T14:30:00+00:00",
 "venue":{"code":"harbourhotel","name":"Harbour Hotel"},"data":{ …the claim… }}

Controleer de handtekening

Elke levering bevat Vfound-Signature: t=<unix time>,v1=<hex>, waarbij de hex een HMAC SHA256 is van t + "." + raw body met het geheim van je endpoint. Weiger leveringen die ouder zijn dan vijf minuten. Nadat je een nieuw ondertekeningsgeheim hebt gemaakt, bevatten leveringen 24 uur lang twee v1-waarden, één voor elk geheim, dus accepteer de levering als een van beide klopt.

// Node.js
const crypto = require("crypto");
function verified(rawBody, header, secret) {
  const parts = header.split(",").map((p) => p.split("="));
  const t = (parts.find(([k]) => k === "t") || [])[1];
  const expected = crypto.createHmac("sha256", secret).update(t + "." + rawBody).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  return fresh && parts.some(([k, v]) => k === "v1" && v.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v)));
}
// PHP
$t = null; $signatures = [];
foreach (explode(',', $header) as $part) {
    [$k, $v] = array_pad(explode('=', $part, 2), 2, '');
    if ($k === 't') { $t = $v; } elseif ($k === 'v1') { $signatures[] = $v; }
}
$expected = hash_hmac('sha256', $t.'.'.$rawBody, $secret);
$ok = abs(time() - (int) $t) < 300
    && count(array_filter($signatures, fn ($s) => hash_equals($expected, $s))) > 0;

De headers bevatten ook Vfound-Event en een unieke Vfound-Delivery-id die je kunt gebruiken om herhalingen te negeren. Webhooks worden alleen naar openbare HTTPS-adressen op poort 443 gestuurd.

Aanmelden via de API

Tools zoals Zapier kunnen hun eigen adressen toevoegen en verwijderen met een sleutel die webhooks:manage heeft. Het ondertekeningsgeheim wordt één keer getoond, in het antwoord op de POST. Het antwoord bevat ook een Location-header met het adres dat je met DELETE aanroept wanneer het abonnement wordt verwijderd.

Een sleutel kan zich alleen aanmelden voor gebeurtenissen waarvan hij de gegevens kan lezen: elke gebeurtenis vraagt om de leesscope van het product ervan (items:read voor gebeurtenissen over voorwerpen, claims:read voor gebeurtenissen over claims, lost_reports:read, parcels:read, checkroom:read, loans:read voor gebeurtenissen over apparatuur, visitors:read voor gebeurtenissen over bezoeken, bezoekerstypen, kiosken en koeriers, en people:read voor gebeurtenissen over personen en de personenlijst). Een sleutel toont en verwijdert alleen de adressen die hij zelf heeft aangemaakt; adressen die in Instellingen of door een andere sleutel zijn toegevoegd, ziet hij niet.

VerzoekWat het doetScope
GET/webhooksDe adressen die deze sleutel heeft aangemaakt, en hun gebeurtenissen.webhooks:manage
POST/webhooksVoeg een adres toe: url (openbaar HTTPS op poort 443) en events, een lijst met gebeurtenissen hierboven die de sleutel kan lezen.webhooks:manage
DELETE/webhooks/{id}Verwijder een adres dat deze sleutel heeft aangemaakt, en zijn leveringsgeschiedenis.webhooks:manage

Leveringsgeschiedenis

Instellingen, Voor ontwikkelaars, toont elke levering aan elk adres van de laatste 30 dagen, met hoe het ging, en stuurt elk ervan opnieuw met dezelfde Vfound-Delivery-id. Daar kun je ook een adres bewerken, een gepauzeerd adres weer inschakelen en een nieuw ondertekeningsgeheim maken. Een adres dat 15 leveringen achter elkaar mislukt, wordt gepauzeerd en de eigenaar van de locatie krijgt een e-mail.

Rapportgegevensfeed (Power BI)

Een eigenaar of manager maakt een feedlink in Rapporten en analyses, onder Power BI-datafeed, voor de producten die hij kiest. De link wordt één keer getoond. Kies in Power BI Get data, dan Web, en plak hem. Elke link leest één locatie en stopt direct wanneer hij wordt ingetrokken, wanneer de persoon die hem maakte geen eigenaar of manager van de locatie meer is, of wanneer de locatie is gepauzeerd of gesloten.

GET /api/feeds/reports/{token}/{dataset} antwoordt met de rijen van één dataset: equipment_loans, equipment_activity, visits of checkroom_tickets. Kies de periode met days (1 tot 366, 90 als je het weglaat) of from en to (YYYY-MM-DD, op de klok van de locatie). GET /api/feeds/reports/{token}/saved/{id} antwoordt met een opgeslagen rapport dat met de hele locatie wordt gedeeld, voor de eigen periode van dat rapport; days, from en to veranderen dat niet. Je kunt het token ook sturen als Authorization: Bearer <token> naar /api/feeds/reports/{dataset} of /api/feeds/reports/saved/{id}. Eén antwoord bevat tot 100,000 rijen in value, dus Get data, Web leest het hele resultaat; zet de lijst value daarna om in een tabel. Het antwoord eindigt met total en truncated: wanneer meer rijen overeenkomen dan één antwoord bevat, is truncated true en noemt @odata.nextLink de rest ($top en $skip bladeren erdoor, voor tools die hem volgen); Get data, Web volgt hem niet, dus kies in dat geval een kortere periode. Wanneer de rijen van een rapport meer dan 400,000 gelezen rijen of meer dan 20 seconden zouden vragen, eindigt het antwoord met error, total null en truncated true; een opgeslagen rapport met groepering antwoordt in plaats daarvan 422 met de reden. Rijen komen in de volgorde waarin ze zijn vastgelegd. Tijden in rijen zijn UTC (ISO 8601); een opgeslagen rapport dat op een datum is gegroepeerd, labelt elke groep met de dag, week, maand, weekdag of het uur op de klok van de locatie. E-mailadressen en de naam en kamer van een gast van de checkroom worden weggelaten, tenzij de link is gemaakt om contactgegevens op te nemen.

AI-assistenten (MCP)

vFound is een Model Context Protocol-server op https://vfound.io/api/mcp, zodat AI-assistenten dingen kunnen opzoeken en aan de balie kunnen helpen. Koppel er een op een van twee manieren: inloggen met vFound, voor assistenten waarvan de connectors inloggen met OAuth, of een API-sleutel, voor clients die een header sturen, zoals Claude Code, Cursor en Visual Studio Code. Hoe dan ook ziet hij alleen de tools die zijn scopes toestaan, voor de producten die je locatie heeft geopend. Een client die met een API-sleutel is gekoppeld, mag ook X-Acting-User sturen; elke tool wordt dan uitgevoerd als dat teamlid, binnen zijn rol.

# Claude Code
claude mcp add --transport http vfound https://vfound.io/api/mcp \
  --header "Authorization: Bearer $VFOUND_KEY"

// Cursor (.cursor/mcp.json)
{"mcpServers":{"vfound":{"url":"https://vfound.io/api/mcp","headers":{"Authorization":"Bearer vf_live_…"}}}}

// Visual Studio Code (.vscode/mcp.json)
{"servers":{"vfound":{"type":"http","url":"https://vfound.io/api/mcp","headers":{"Authorization":"Bearer vf_live_…"}}}}
ToolWat het doetScope
search_found_itemsZoek gevonden voorwerpen op woorden zoals “zwarte iPhone”items:read
list_expected_visitorsBezoekers die zijn uitgenodigd en er nog niet zijnvisitors:read
list_visitors_on_siteBezoekers die nu zijn aangemeldvisitors:read
list_visitor_typesBezoekerstypen en hun regelsvisitors:read
visitor_analyticsTotalen, patronen en gemiddelde verblijfsduur van bezoekersvisitors:read
visitor_registration_linkDe zelfregistratielink van de locatievisitors:read
list_couriers_on_siteKoeriers die via Visitors zijn aangemeldparcels:read
list_waiting_parcelsPakketten die wachten om opgehaald te wordenparcels:read
detect_parcel_trackingNormaliseer een trackingnummer en herken de vervoerderparcels:read
parcel_pickup_queueMensen die wachten bij de pakketbalieparcels:read
parcel_shelvesCapaciteit en bezetting van de pakketplankenparcels:read
parcel_analyticsPakketvolume, vervoerders en prestaties bij het ophalenparcels:read
list_outgoing_parcelsUitgaande pakketten en hun overdrachtsstatusparcels:read
list_parcel_roundsBezorgrondes en stops van pakkettenparcels:read
list_checkroom_exit_queueTickets waarvan de gasten bij de uitgang wachtencheckroom:read
mark_checkroom_readyMarkeer een wachtend ticket als klaar en breng de gast op de hoogtecheckroom:write
list_checkroom_stationsCheckroomposten en nummerreeksencheckroom:read
list_checkroom_eventsRecente en aankomende checkroomevenementencheckroom:read
checkroom_reportCheckroomvolume, teruggavetijd en totalen van kostencheckroom:read
list_queue_linesRijen, mensen die wachten en de geschatte wachttijd nuqueue:read
list_queue_waitingMensen die vandaag wachten, in de volgorde van oproepenqueue:read
queue_reportQueue-totalen en mediane wacht- en servicetijd in minutenqueue:read
call_next_in_queueRoep de volgende persoon op naar een baliequeue:write
mark_queue_ticket_servedMarkeer de persoon bij een balie als geholpenqueue:write
list_overdue_equipmentApparatuur die te laat is, en wie het heeftloans:read
list_equipment_kitsOpgeslagen groepen apparatuurloans:read
create_equipment_kitSla een herbruikbare set apparatuur op zonder die uit te gevenloans:write
list_equipment_reservationsReserveringen op tijd en statusloans:read
reserve_equipmentReserveer een artikel of categorie zonder het uit te gevenloans:write
book_repeating_reservationBoek een artikel, categorie of ruimte elke dag of weekloans:write
move_reservationVerplaats een reservering naar nieuwe tijden of een ander artikel van de categorieloans:write
list_waitlistDe mensen die wachten op een tijd die al bezet wasloans:read
join_waitlistZet iemand op de wachtlijstloans:write
list_space_bookingsElke kamer, werkplek of parkeerplaats en de boekingen ervan tussen twee tijdenloans:read
book_spaceBoek een kamer of ruimte voor een persoon en tijd; die wordt nooit uitgegevenloans:write
list_equipment_rulesUitgifteregels van de locatie en per categorieloans:read
save_equipment_ruleMaak een categorieregel aan of vervang hemloans:write
list_equipment_maintenanceOnderhoudsgeschiedenis van apparatuur en aankomend werkloans:read
list_equipment_service_plansTerugkerende schema's voor service, kalibratie, veiligheidstest, inspectie en schoonmaak en welke aan de beurt zijnloans:read
update_equipment_work_orderWijzig of sluit een werkopdracht voor apparatuurloans:write
get_equipment_maintenance_costsKosten van service, reparatie en schoonmaak per artikelloans:read
get_equipment_valuationDe waarde van de apparatuur op een datum na afschrijving (eigenaren en managers)loans:read
list_equipment_substancesHet register van gevaarlijke stoffen: stof, plek, gevarenklassen en data van beoordeling (een registratie, geen veiligheidsadvies)loans:read
get_equipment_fundingWat elk fonds, elke subsidie of kostenplaats heeft gekocht en welk werk eraan is toegerekend (eigenaren en managers)loans:read
get_equipment_plannerGepland werk en open werkopdrachten per eigen dag van de locatieloans:read
list_equipment_licencesLicenties voor de apparatuur met aantal gebruikers en einddata (eigenaren en managers)loans:read
get_equipment_expiriesVerzekeringen en licenties die binnenkort aflopen of al zijn afgelopen (eigenaren en managers)loans:read
log_equipment_maintenanceLeg service, kalibratie, een veiligheidstest, een inspectie, schoonmaak, een reparatie of een notitie vastloans:write
list_equipment_stocktakesRecente inventarisaties en hun tellingenloans:read
start_equipment_stocktakeStart een inventarisatieloans:write
scan_equipment_stocktakeLeg één artikel vast in een open inventarisatieloans:write
scan_many_equipment_stocktakeTel veel codes tegelijk in een open inventarisatieloans:write
finish_equipment_stocktakeRond een inventarisatie af en geef terug wat ontbreektloans:write
list_equipment_transfersBinnenkomende en uitgaande verplaatsingen zonder gegevens van personenloans:read
preview_equipment_importValideer een CSV van apparatuur zonder die op te slaanloans:write
find_personZoek iemand op in de personenlijstpeople:read
export_peopleExporteer de personenlijst als CSV die veilig is voor formulespeople:read
directory_sync_statusControleer de opgeslagen CSV-koppeling en de laatste run ervanpeople:read
run_directory_syncVoer de opgeslagen CSV-koppeling nu uitpeople:write
email_my_vfoundStuur één persoon zijn ondertekende privépagina per e-mailpeople:write
invite_visitorNodig een bezoeker uit, die een pas per e-mail krijgtvisitors:write
approve_visitKeur een bezoekverzoek goed dat in behandeling isvisitors:write
list_free_workplace_spacesZoek vrije werkplekken, vergaderruimtes of parkeerplaatsen voor een tijdvisitors:read
book_workplace_spaceBoek een werkplek, vergaderruimte of parkeerplaats voor een persoonvisitors:write
request_visit_cateringVraag catering aan bij een bezoek, uit de opties die de locatie opgeeftvisitors:write
list_appointment_pagesToon de afsprakenpagina's van de locatie en of elke openstaat voor bezoekersvisitors:read
list_staff_on_siteToon de mensen op de medewerkerslijst die nu zijn aangemeld, op kantoor of op afstandvisitors:read
sign_staff_in_or_outMeld een persoon op de medewerkerslijst aan of afvisitors:write
list_visitor_assets_not_returnedToon dingen die aan bezoekers zijn meegegeven en nog niet als teruggebracht zijn gemarkeerdvisitors:read
issue_visitor_assetLeg een ding vast dat aan een verwacht of aangemeld bezoek is meegegevenvisitors:write
return_visitor_assetMarkeer een ding dat aan een bezoek is meegegeven als teruggebrachtvisitors:write
start_roll_callStart een appèl of geef het actieve appèl terugvisitors:write
mark_visitor_safeMarkeer één bezoeker als veiligvisitors:write
create_kiosk_pairingMaak een koppelcode voor een kiosk van tien minuten aanvisitors:write
log_parcelRegistreer een pakket en stuur de ontvanger een e-mailparcels:write
remind_parcelHerinner een ontvanger eraan een pakket op te halenparcels:write
remind_parcelsHerinner tot 200 geselecteerde ontvangers van pakkettenparcels:write
log_outgoing_parcelVoeg een uitgaand pakket toe aan het koerierslogboekparcels:write
create_parcel_roundMaak een bezorgronde van wachtende pakkettenparcels:write
extend_loanGeef een persoon meer tijdloans:write

Elke tool voert het API-verzoek hierboven uit met dezelfde controles, dus een assistent kan nooit meer doen dan zijn sleutel of verbinding. Er zijn geen tools die iets overhandigen, iemand aan- of afmelden, over een claim beslissen of verwijderen. Elk antwoord telt mee voor de 120 verzoeken per minuut van de sleutel of verbinding.

Inloggen met vFound

Voeg https://vfound.io/api/mcp toe als connector in je eigen assistent. De assistent vindt zelf hoe hij moet inloggen en opent een vFound-pagina, waar een eigenaar of manager zoals gewoonlijk inlogt in zijn werkruimte, de locatie kiest en in gewone woorden ziet wat de assistent mag doen, en alles kan uitvinken. Medewerkers en leden met alleen kijkrechten kunnen geen assistent koppelen. De assistent is van je eigen locatie: je abonnement bij de aanbieder ervan betaalt voor de AI, en vFound ontvangt alleen de toolverzoeken die hij stuurt.

Een verbinding handelt als de persoon die haar heeft toegestaan, met dezelfde controles als een API-sleutel: ze stopt met werken als die persoon de locatie niet meer beheert of de locatie niet actief is, ze wijzigt niets zolang het abonnement is gepauzeerd, en ze ziet alleen tools voor geopende producten. Het toegangstoken is een uur geldig en de assistent vernieuwt het zelf; een verbinding die 30 dagen niet is gebruikt, logt opnieuw in. Bekijk elke verbinding, wie haar koppelde en wanneer ze voor het laatst is gebruikt in Instellingen, Voor ontwikkelaars, waar Ontkoppelen haar direct stopt. Het token werkt alleen op het MCP-endpoint, niet op de REST API; een app die de REST API nodig heeft, koppelt zoals het volgende gedeelte zegt.

Voor ontwikkelaars van clients: OAuth 2.1 zoals de MCP-autorisatiespecificatie het beschrijft, alleen met de authorization code flow en PKCE (S256). Discovery: /.well-known/oauth-protected-resource (RFC 9728, resource https://vfound.io/api/mcp) en /.well-known/oauth-authorization-server (RFC 8414); een verzoek zonder token krijgt een WWW-Authenticate-header die de eerste noemt. Clients registreren zichzelf op /oauth/register (RFC 7591) als openbare clients zonder geheim; redirectadressen moeten https gebruiken, of http alleen voor localhost of 127.0.0.1, en moeten dan exact overeenkomen. Daarna /oauth/authorize, /oauth/token (codes zijn 60 seconden geldig en werken één keer; refresh-tokens worden bij elk gebruik vervangen, en een oud token opnieuw gebruiken verbreekt de verbinding met de assistent) en /oauth/revoke (RFC 7009). Scopes gebruiken de namen van de API-sleutels hierboven; stuur resource=https://vfound.io/api/mcp mee (RFC 8707).

Inloggen met vFound voor andere apps

Een app die geen AI-assistent is, zoals een voorraad-, boekings- of HR-systeem, kan op dezelfde manier met de REST API verbinden in plaats van met een API-sleutel: stuur resource=https://vfound.io/api/v1 naar /oauth/authorize en /oauth/token, met scopes in de namen van de API-sleutels, behalve webhooks:manage, die een app niet kan krijgen. Een eigenaar of manager logt in, ziet de naam van de app en in gewone woorden wat die mag doen, kan alles uitvinken en geeft toestemming. De verbinding handelt als die persoon met dezelfde controles als een API-sleutel: ze stopt met werken als die persoon de locatie niet meer beheert of de locatie niet actief is, ze wijzigt niets zolang het abonnement is gepauzeerd, en ze mag 120 verzoeken per minuut doen, net als een sleutel. X-Acting-User werkt alleen met een API-sleutel. Het toegangstoken werkt alleen op de REST API, nooit op het MCP-endpoint, en een toestemming die voor het ene is getoond, keurt het andere nooit goed. Ze staat vermeld in Instellingen, Voor ontwikkelaars als een app die de vFound API gebruikt, waar Ontkoppelen haar direct stopt. Discovery: /.well-known/oauth-protected-resource/api/v1; de rest is de flow hierboven.

Fouten

Fouten zijn JSON met een message; validatiefouten voegen errors per veld toe. 401 betekent geen geldige sleutel, 403 een ontbrekende scope, een sleutel waarvan de maker de locatie niet meer beheert, een teamlid in X-Acting-User dat geen actief lid is of wiens rol de scope niet toestaat, een locatie die niet actief is, of een wijziging die is gestuurd terwijl het abonnement is gepauzeerd, 404 niet gevonden op je locatie, 422 ongeldige invoer en 429 te veel verzoeken.

Wanneer een wijziging niet kan gebeuren vanwege de huidige status van het dossier, is het antwoord 422 met ook een vaste code. De codes veranderen nooit van naam:

CodeWat het betekent
parcel_not_waitingHet pakket wacht niet meer: het is al opgehaald, teruggestuurd of bezorgd.
tracking_duplicateEr wacht hier al een pakket met dit trackingnummer.
no_emailDe persoon of bezoeker heeft geen e-mailadres, dus er kan niets worden gestuurd.
capacity_fullElk checkroomnummer is in gebruik.
already_checked_inHet checkroomticket is al ingecheckt.
already_handed_backHet checkroomticket is al teruggegeven.
nothing_to_hand_backHet checkroomticket heeft niets om terug te geven.
number_in_useDat checkroomnummer is al in gebruik.
ticket_closedAlleen een open checkroomticket kan per e-mail worden gestuurd.
item_outDe apparatuur is uitgegeven aan iemand. Neem het eerst in.
item_in_repairDe apparatuur is opzij gelegd voor reparatie.
item_retiredDe apparatuur is buiten gebruik, dus ze kan niet worden uitgegeven of gereserveerd.
reservation_conflictIemand heeft het artikel, of het laatste vrije in zijn categorie, in deze tijd gereserveerd, of er wordt verwacht dat het nog is uitgegeven.
already_backDe apparatuur is al ingenomen.
not_outDe apparatuur is niet uitgegeven, dus ze kan niet meer tijd krijgen, geen herinnering krijgen en niet als niet-terugkomend worden gemarkeerd.
borrower_overdueDe persoon heeft apparatuur die te laat is, en de locatie of de categorie staat niets meer toe totdat die terug is.
borrower_item_limitHiermee zou de persoon meer artikelen krijgen dan de locatie of de categorie tegelijk toestaat.
reservation_not_readyDe reservering is nog niet goedgekeurd, of is al opgehaald of geannuleerd.
reservation_item_mismatchDe uitgifte bevat niet het artikel waarvoor de reservering is.
reservation_category_mismatchDe uitgifte bevat een artikel buiten de gereserveerde categorie.
reservation_borrower_mismatchDe reservering hoort bij een andere persoon.
reservation_too_longDe reservering is langer dan de categorie kan worden meegenomen. Alleen reserveringen die via My vFound zijn gemaakt, hebben deze beperking.
reservation_daily_limitDe persoon heeft de laatste 24 uur al 5 reserveringen via My vFound gemaakt.
booking_noticeDe reservering begint eerder dan de minimale vooraankondiging van de categorie toestaat.
booking_too_far_aheadDe boeking, uitgifte of nieuwe inlevertijd eindigt later dan de categorie vooruit kan worden geboekt.
desk_closedDe reservering zou beginnen op een dag waarop de balie voor apparatuur gesloten is.
kit_unavailableEen deel van een set of winkelwagen is voor deze tijd niet beschikbaar, dus er is niets gereserveerd. Het veld unavailable toont elk deel en waarom.
borrower_not_in_groupDe locatie laat alleen mensen met een persoonstype meenemen of boeken, en deze persoon heeft er geen (of is getypt in plaats van gekozen uit de personenlijst).
category_not_allowedGeen van de persoonstypen van deze persoon staat deze categorie toe.
borrower_on_holdMeenemen is gepauzeerd voor deze persoon: medewerkers hebben een blokkade geplaatst, de locatie pauzeert het meenemen na herhaald te laat terugbrengen, of de persoon is minstens het bedrag verschuldigd waarbij de locatie blokkeert (kind charges). Het veld hold geeft de soort en tot wanneer.
space_too_smallMeer mensen dan de kamer of ruimte kan bevatten (de capaciteit ervan).
kit_lockedDe apparatuur hoort bij een vergrendelde set, die alleen als geheel wordt uitgegeven: neem elk benoemd artikel van de set mee.
approval_not_yoursDe locatie heeft goedkeurders in volgorde ingesteld en deze persoon is niet de volgende (of de locatie laat niemand een stap voor hem overslaan).
project_not_approvedDe boeking hoort bij een project dat nog niet is goedgekeurd, dus er kan niets worden opgehaald.
not_enough_creditsDe locatie gebruikt boekingstegoeden en deze persoon heeft er geen meer. Geef er eerst wat. Een boeking die wordt geannuleerd of nooit wordt opgehaald, geeft het tegoed terug.
risk_assessment_pendingDe boeking heeft een risicobeoordeling die niet is goedgekeurd, dus er kan niets worden opgehaald.
series_unavailableEen terugkerende boeking kon niet worden gemaakt omdat minstens één van de tijden bezet is of tegen een boekingsregel ingaat, dus er is niets gereserveerd. Het veld skipped toont elke tijd en waarom.
time_availableDe tijd waarop iemand wilde wachten is vrij, dus boek die in plaats van op de wachtlijst te komen.
space_not_handed_outEen kamer of ruimte wordt voor zijn tijd geboekt en nooit uitgegeven, dus ze kan niet worden uitgegeven of opgehaald.
stock_shortEr is niet genoeg van dit voorraadartikel op de genoemde plek (en batch), dus er is niets veranderd. Het veld available geeft de hoeveelheid daar.
stock_issue_closedAlles van deze uitgifte van voorraad is al terug of afgeschreven.
order_closedEen inkooporder is afgerond of geannuleerd en kan niet meer veranderen.
order_over_receivedEr is meer ingevoerd dan een regel van een inkooporder nog verwacht.
order_not_placedVoorraad kan niet worden ontvangen tegen een inkooporder die nog een concept is.
fees_offKosten staan uit voor deze locatie. Schakel ze eerst in bij Beleid voor de balie en het gebruik.
entry_closedDie kostenregel of factuur kan niet meer op deze manier veranderen: het bedrag is verrekend of kwijtgescholden, de betaling is ongeldig gemaakt, de borg is teruggegeven of ingehouden, of de factuur is ongeldig.
on_invoiceHet bedrag staat op een uitgegeven factuur. Maak de factuur eerst ongeldig en scheld het bedrag dan kwijt.
not_lateDe uitgifte kwam niet te laat terug volgens de regels van de locatie voor boetes bij te laat, of is nog uitgegeven.
nothing_to_invoiceDe persoon heeft in die valuta geen openstaand bedrag dat nog niet op een uitgegeven factuur staat.
charge_unavailableEen van de gekozen bedragen staat niet open, staat op een andere factuur of is voor iemand anders.
desk_keptDe werkplek wordt op een van de gevraagde dagen voor een andere persoon vrijgehouden.
desk_has_bookingsDe werkplek voor deze persoon vrijhouden zou botsen met open boekingen van anderen op die dagen. Annuleer die eerst.
booking_closedDe boeking van de werkplek, kamer of parkeerplaats is geannuleerd of vrijgegeven, dus ze kan niet worden ingecheckt.
check_in_closedInchecken opent 15 minuten voordat een boeking begint en sluit wanneer die eindigt.
item_service_dueDe locatie houdt apparatuur die onderhoud nodig heeft tegen om uitgegeven te worden, en de servicedatum van dit artikel is gekomen of een van zijn schema's is aan de beurt. Leg eerst het werk vast.
item_failed_inspectionDe locatie houdt apparatuur die onderhoud nodig heeft tegen om uitgegeven te worden, en de laatste controle van dit artikel is mislukt. Leg eerst een geslaagde controle vast.
work_order_closedDeze werkopdracht is al gesloten en kan niet meer worden gewijzigd.
already_disposedDit artikel is al afgestoten.
not_disposedDit artikel is niet afgestoten, dus er valt niets ongedaan te maken.
item_disposedDit artikel is afgestoten. Maak de afstoting ongedaan voordat je het opnieuw gebruikt.
training_requiredEen categorieregel of het artikel vereist een training die de persoon niet heeft, of alleen heeft na de vervaldatum ervan. Het veld training noemt wat ontbreekt.
stocktake_openEr is al een inventarisatie open. Rond die eerst af.
item_unavailableDe apparatuur is niet beschikbaar of opzij gelegd voor reparatie, dus ze kan geen verplaatsing starten.
transfer_openDe apparatuur heeft al een open verplaatsing.
transfer_not_readyAlleen een klaargemaakte verplaatsing kan worden verzonden.
transfer_not_in_transitAlleen apparatuur die onderweg is, kan worden ontvangen of met een probleem worden gemarkeerd.
transfer_already_sentEen verzonden verplaatsing kan niet meer worden geannuleerd of afgewezen.
already_signed_inDe bezoeker is al aangemeld.
visit_closedHet bezoek is gesloten. Meld de bezoeker aan als een nieuw bezoek.
not_signed_inDe bezoeker is niet aangemeld.
not_expectedAlleen een verwacht bezoek kan worden geannuleerd of een pas krijgen.
approval_requiredHet bezoek heeft goedkeuring nodig voordat de bezoeker zich kan aanmelden.
visit_not_valid_todayDe pas kan vandaag niet meer worden gebruikt, of vandaag valt buiten de data ervan.
plus_one_not_allowedDe pas staat geen gasten toe, of is niet meer goedgekeurd, verwacht of geldig.
plus_one_limitDe bezoeker heeft alle gasten toegevoegd die de pas toestaat.
nobody_to_sign_inNiemand in de groep van het bezoek wordt vandaag verwacht.
visitor_capacity_fullAls de bezoeker zich aanmeldt, wordt de limiet van de locatie of van het bezoekerstype voor tegelijk aangemelde bezoekers overschreden.

Een bezoeker aan de balie aanmelden antwoordt 409 met een code wanneer de bezoeker eerst door een teamlid moet worden gecontroleerd. Het antwoord noemt alleen de soort treffer (blocklist, building, restricted_party of answers); de regel, de naam en de reden ervan zijn voor het team van de locatie en staan nooit in een API-antwoord. Stuur het verzoek opnieuw met screening_reviewed op true pas nadat een teamlid de treffer heeft gecontroleerd. Daarvoor is een sleutel met de scope visitors:screening nodig (standaard uit, net als de toegang van elke andere sleutel ertoe), en een sleutel die een teamlid noemt in X-Acting-User heeft een teamlid nodig wiens rol over bezoeken beslist. De bevestiging wordt vastgelegd als die van de sleutel, met zijn naam, nooit als het teamlid dat de sleutel heeft aangemaakt. Zonder de scope is het antwoord 403 met screening_scope. Hetzelfde geldt voor het goedkeuren van een bezoek dat door een treffer wordt tegengehouden:

CodeWat het betekent
screening_matchDe bezoeker komt overeen met een van de blokkeerlijsten van de locatie, een controle door het team of de screeninglijst. Een teamlid moet bevestigen dat hij de treffer heeft gecontroleerd voordat de bezoeker wordt aangemeld.
screening_scopeHet verzoek bevestigt of keurt een screeningtreffer goed, en de sleutel heeft de scope visitors:screening niet (of het teamlid dat in X-Acting-User wordt genoemd, beslist niet over bezoeken).

Workflowchecklists

Een locatie met vFound Enterprise kan de stappen instellen die haar medewerkers bevestigen op een sleutelmoment: een gevonden voorwerp registreren, overhandigen, schenken of afvoeren; een pakket overhandigen of terugsturen; inchecken of teruggeven bij de checkroom; apparatuur uitgeven of innemen; en een bezoeker aan- of afmelden. Zolang er een geldt, nemen deze verzoeken een veld checklist aan: [{"key": "id_checked", "done": true}, {"key": "reason", "note": "Refused"}], of een object van key naar true of notitietekst. POST /items, PATCH /items/{id}, POST /items/{id}/disposition, POST /claims/{id}/handover, POST /claims/{id}/decision, POST /parcels/{id}/collect, POST /parcels/{id}/return, POST /parcels/bulk-return, POST /parcels/rounds/{round}/stops/{stop}/deliver, POST /checkroom/tickets, POST /checkroom/tickets/{id}/hand-back, POST /loans, POST /loans/{id}/return, POST /loans/returns, POST /loans/checkouts, POST /loans/reservations/{id}/pickup, POST /visitors, POST /visitors/{id}/sign-in en POST /visitors/{id}/sign-out accepteren het. Zonder de vereiste stappen is het antwoord 422 met de code checklist_incomplete en een object checklist dat de stappen noemt die nog moeten worden bevestigd, en er verandert niets. Wanneer er geen checklist geldt, wordt het veld genegeerd. De voltooide checklists, met wie ze bevestigde en wanneer, staan in checklists bij de antwoorden over één voorwerp, claim, pakket, ticket, uitgifte en bezoek.

CodeWat het betekent
checklist_incomplete422: een workflowchecklist geldt voor deze stap en de vereiste stappen zijn niet bevestigd.

Nieuwe pogingen met een Idempotency-Key-header kunnen ook antwoorden met een code:

CodeWat het betekent
idempotency_key_invalid400: de header bestaat niet uit 1 tot 191 zichtbare ASCII-tekens.
idempotency_key_reused422: deze sleutel is al gebruikt voor een ander verzoek.
idempotency_in_progress409: het eerste verzoek met deze sleutel loopt nog. Probeer het zo meteen opnieuw.
offline_in_progressHet eerste exemplaar van deze offline actie wordt nog opgeslagen. Het apparaat stuurt hem zo meteen opnieuw.

Een verzoek dat een teamlid noemt in X-Acting-User kan ook antwoorden met een code:

CodeWat het betekent
acting_user_refused403: de header noemt niet precies één actief teamlid van deze locatie, of de sleutel is een verbinding die via inloggen is gemaakt.
acting_user_role403: het genoemde teamlid kan de scope van deze bewerking niet gebruiken met zijn rol op de locatie.
Vragen, of een toepassing die we moeten ondersteunen? Mail ons. We lezen elk bericht.