[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Fget-subscriber":3},{"_path":4,"title":5,"description":6,"navigation":7,"image":13,"head":18,"body":32},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Fget-subscriber","Get Subscriber API Endpoint · Waitlister Documentation","Learn how to retrieve detailed information about a specific subscriber using the Waitlister API.",{"title":8,"parent":9,"group":10,"description":11,"order":12},"Get Subscriber","Endpoints","Advanced","Retrieve detailed information about a specific subscriber by ID or email.",3,{"src":14,"width":15,"height":16,"alt":17},"https:\u002F\u002Ffirebasestorage.googleapis.com\u002Fv0\u002Fb\u002Fwaitinglist-app-c24fc.appspot.com\u002Fo\u002Fdocs-og-image.png?alt=media&token=85e60b24-c882-4f84-aa9e-ef85e1ae4bb5",400,300,"Waitlister API Get Subscriber",{"meta":19},[20,23,26,29],{"name":21,"content":22},"keywords","get subscriber, subscriber details, waitlist api, api integration, subscriber lookup",{"name":24,"content":25},"robots","index, follow",{"name":27,"content":28},"author","Waitlister",{"name":30,"content":31},"copyright","© 2026 Waitlister",{"type":33,"children":34,"toc":891},"root",[35,49,55,60,67,105,111,118,128,134,196,202,215,226,233,703,709,722,731,743,752,758,764,775,781,790,796,802,825,830,836,848,871,877],{"type":36,"tag":37,"props":38,"children":39},"element","p",{},[40],{"type":36,"tag":41,"props":42,"children":45},"span",{"className":43},[44],"secondary-heading",[46],{"type":47,"value":48},"text","API Reference \u002F Endpoints",{"type":36,"tag":50,"props":51,"children":53},"h1",{"id":52},"get-subscriber",[54],{"type":47,"value":8},{"type":36,"tag":37,"props":56,"children":57},{},[58],{"type":47,"value":59},"The Get Subscriber endpoint allows you to retrieve detailed information about a specific subscriber by either their unique ID or email address. This is useful for looking up individual subscriber details or verifying subscriber status.",{"type":36,"tag":61,"props":62,"children":64},"h2",{"id":63},"endpoint-details",[65],{"type":47,"value":66},"Endpoint Details",{"type":36,"tag":68,"props":69,"children":70},"ul",{},[71,90],{"type":36,"tag":72,"props":73,"children":74},"li",{},[75,81,83],{"type":36,"tag":76,"props":77,"children":78},"strong",{},[79],{"type":47,"value":80},"URL",{"type":47,"value":82},": ",{"type":36,"tag":84,"props":85,"children":87},"code",{"className":86},[],[88],{"type":47,"value":89},"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002F{waitlist-key}\u002Fsubscribers\u002F{id-or-email}",{"type":36,"tag":72,"props":91,"children":92},{},[93,98,99],{"type":36,"tag":76,"props":94,"children":95},{},[96],{"type":47,"value":97},"Method",{"type":47,"value":82},{"type":36,"tag":84,"props":100,"children":102},{"className":101},[],[103],{"type":47,"value":104},"GET",{"type":36,"tag":61,"props":106,"children":108},{"id":107},"request",[109],{"type":47,"value":110},"Request",{"type":36,"tag":112,"props":113,"children":115},"h3",{"id":114},"headers",[116],{"type":47,"value":117},"Headers",{"type":36,"tag":119,"props":120,"children":122},"pre",{"code":121},"X-Api-Key: your-api-key\n",[123],{"type":36,"tag":84,"props":124,"children":126},{"__ignoreMap":125},"",[127],{"type":47,"value":121},{"type":36,"tag":112,"props":129,"children":131},{"id":130},"path-parameters",[132],{"type":47,"value":133},"Path Parameters",{"type":36,"tag":135,"props":136,"children":137},"table",{},[138,157],{"type":36,"tag":139,"props":140,"children":141},"thead",{},[142],{"type":36,"tag":143,"props":144,"children":145},"tr",{},[146,152],{"type":36,"tag":147,"props":148,"children":149},"th",{},[150],{"type":47,"value":151},"Parameter",{"type":36,"tag":147,"props":153,"children":154},{},[155],{"type":47,"value":156},"Description",{"type":36,"tag":158,"props":159,"children":160},"tbody",{},[161,179],{"type":36,"tag":143,"props":162,"children":163},{},[164,174],{"type":36,"tag":165,"props":166,"children":167},"td",{},[168],{"type":36,"tag":84,"props":169,"children":171},{"className":170},[],[172],{"type":47,"value":173},"waitlist-key",{"type":36,"tag":165,"props":175,"children":176},{},[177],{"type":47,"value":178},"Your unique waitlist key, found in your waitlist settings",{"type":36,"tag":143,"props":180,"children":181},{},[182,191],{"type":36,"tag":165,"props":183,"children":184},{},[185],{"type":36,"tag":84,"props":186,"children":188},{"className":187},[],[189],{"type":47,"value":190},"id-or-email",{"type":36,"tag":165,"props":192,"children":193},{},[194],{"type":47,"value":195},"Either the subscriber's unique ID or their email address",{"type":36,"tag":61,"props":197,"children":199},{"id":198},"response",[200],{"type":47,"value":201},"Response",{"type":36,"tag":112,"props":203,"children":205},{"id":204},"success-response-200",[206,208],{"type":47,"value":207},"Success Response ",{"type":36,"tag":84,"props":209,"children":212},{"className":210},[211],"inline-code-green",[213],{"type":47,"value":214},"200",{"type":36,"tag":119,"props":216,"children":221},{"code":217,"language":218,"meta":125,"className":219},"{\n  \"success\": true,\n  \"data\": {\n    \"subscriber\": {\n      \"id\": \"xyzABC123\",\n      \"email\": \"user@example.com\",\n      \"deliverability\": \"unconfirmed\",\n      \"name\": \"John Doe\",\n      \"phone\": \"+1234567890\",\n      \"position\": 42,\n      \"inflated_position\": 42,\n      \"points\": 150,\n      \"referral_code\": \"happy-star-4f3d\",\n      \"referred_by\": \"cool-moon-9e2a\",\n      \"referral_count\": 3,\n      \"sign_up_token\": \"abc123xyz\",\n      \"thank_you_url\": \"https:\u002F\u002Fwaitlister.me\u002Fthank-you\u002Fyour-waitlist-key\u002Fabc123xyz\",\n      \"metadata\": {\n        \"company\": \"Acme Inc\",\n        \"role\": \"Developer\",\n        \"custom_field\": \"custom value\"\n      },\n      \"referring_domain\": \"twitter.com\",\n      \"ip_address\": \"192.168.1.1\",\n      \"country\": \"US\",\n      \"city\": \"San Francisco\",\n      \"timezone\": \"America\u002FLos_Angeles\",\n      \"joined_with\": \"api\",\n      \"joined_at\": 1682345678901\n    }\n  }\n}\n","json",[220],"language-json",[222],{"type":36,"tag":84,"props":223,"children":224},{"__ignoreMap":125},[225],{"type":47,"value":217},{"type":36,"tag":227,"props":228,"children":230},"h4",{"id":229},"subscriber-object-fields",[231],{"type":47,"value":232},"Subscriber Object Fields",{"type":36,"tag":135,"props":234,"children":235},{},[236,256],{"type":36,"tag":139,"props":237,"children":238},{},[239],{"type":36,"tag":143,"props":240,"children":241},{},[242,247,252],{"type":36,"tag":147,"props":243,"children":244},{},[245],{"type":47,"value":246},"Field",{"type":36,"tag":147,"props":248,"children":249},{},[250],{"type":47,"value":251},"Type",{"type":36,"tag":147,"props":253,"children":254},{},[255],{"type":47,"value":156},{"type":36,"tag":158,"props":257,"children":258},{},[259,281,302,323,344,365,387,408,429,450,471,492,513,534,556,577,598,619,640,661,682],{"type":36,"tag":143,"props":260,"children":261},{},[262,271,276],{"type":36,"tag":165,"props":263,"children":264},{},[265],{"type":36,"tag":84,"props":266,"children":268},{"className":267},[],[269],{"type":47,"value":270},"id",{"type":36,"tag":165,"props":272,"children":273},{},[274],{"type":47,"value":275},"String",{"type":36,"tag":165,"props":277,"children":278},{},[279],{"type":47,"value":280},"Unique identifier for the subscriber",{"type":36,"tag":143,"props":282,"children":283},{},[284,293,297],{"type":36,"tag":165,"props":285,"children":286},{},[287],{"type":36,"tag":84,"props":288,"children":290},{"className":289},[],[291],{"type":47,"value":292},"email",{"type":36,"tag":165,"props":294,"children":295},{},[296],{"type":47,"value":275},{"type":36,"tag":165,"props":298,"children":299},{},[300],{"type":47,"value":301},"Subscriber's email address",{"type":36,"tag":143,"props":303,"children":304},{},[305,314,318],{"type":36,"tag":165,"props":306,"children":307},{},[308],{"type":36,"tag":84,"props":309,"children":311},{"className":310},[],[312],{"type":47,"value":313},"deliverability",{"type":36,"tag":165,"props":315,"children":316},{},[317],{"type":47,"value":275},{"type":36,"tag":165,"props":319,"children":320},{},[321],{"type":47,"value":322},"Email deliverability status",{"type":36,"tag":143,"props":324,"children":325},{},[326,335,339],{"type":36,"tag":165,"props":327,"children":328},{},[329],{"type":36,"tag":84,"props":330,"children":332},{"className":331},[],[333],{"type":47,"value":334},"name",{"type":36,"tag":165,"props":336,"children":337},{},[338],{"type":47,"value":275},{"type":36,"tag":165,"props":340,"children":341},{},[342],{"type":47,"value":343},"Subscriber's name (if provided)",{"type":36,"tag":143,"props":345,"children":346},{},[347,356,360],{"type":36,"tag":165,"props":348,"children":349},{},[350],{"type":36,"tag":84,"props":351,"children":353},{"className":352},[],[354],{"type":47,"value":355},"phone",{"type":36,"tag":165,"props":357,"children":358},{},[359],{"type":47,"value":275},{"type":36,"tag":165,"props":361,"children":362},{},[363],{"type":47,"value":364},"Subscriber's phone number (if provided)",{"type":36,"tag":143,"props":366,"children":367},{},[368,377,382],{"type":36,"tag":165,"props":369,"children":370},{},[371],{"type":36,"tag":84,"props":372,"children":374},{"className":373},[],[375],{"type":47,"value":376},"position",{"type":36,"tag":165,"props":378,"children":379},{},[380],{"type":47,"value":381},"Number",{"type":36,"tag":165,"props":383,"children":384},{},[385],{"type":47,"value":386},"Subscriber's real position in the waitlist",{"type":36,"tag":143,"props":388,"children":389},{},[390,399,403],{"type":36,"tag":165,"props":391,"children":392},{},[393],{"type":36,"tag":84,"props":394,"children":396},{"className":395},[],[397],{"type":47,"value":398},"inflated_position",{"type":36,"tag":165,"props":400,"children":401},{},[402],{"type":47,"value":381},{"type":36,"tag":165,"props":404,"children":405},{},[406],{"type":47,"value":407},"Public-facing position with any position inflation offset applied",{"type":36,"tag":143,"props":409,"children":410},{},[411,420,424],{"type":36,"tag":165,"props":412,"children":413},{},[414],{"type":36,"tag":84,"props":415,"children":417},{"className":416},[],[418],{"type":47,"value":419},"points",{"type":36,"tag":165,"props":421,"children":422},{},[423],{"type":47,"value":381},{"type":36,"tag":165,"props":425,"children":426},{},[427],{"type":47,"value":428},"Subscriber's points",{"type":36,"tag":143,"props":430,"children":431},{},[432,441,445],{"type":36,"tag":165,"props":433,"children":434},{},[435],{"type":36,"tag":84,"props":436,"children":438},{"className":437},[],[439],{"type":47,"value":440},"referral_code",{"type":36,"tag":165,"props":442,"children":443},{},[444],{"type":47,"value":275},{"type":36,"tag":165,"props":446,"children":447},{},[448],{"type":47,"value":449},"Subscriber's unique referral code",{"type":36,"tag":143,"props":451,"children":452},{},[453,462,466],{"type":36,"tag":165,"props":454,"children":455},{},[456],{"type":36,"tag":84,"props":457,"children":459},{"className":458},[],[460],{"type":47,"value":461},"referred_by",{"type":36,"tag":165,"props":463,"children":464},{},[465],{"type":47,"value":275},{"type":36,"tag":165,"props":467,"children":468},{},[469],{"type":47,"value":470},"Referral code of the user who referred this subscriber",{"type":36,"tag":143,"props":472,"children":473},{},[474,483,487],{"type":36,"tag":165,"props":475,"children":476},{},[477],{"type":36,"tag":84,"props":478,"children":480},{"className":479},[],[481],{"type":47,"value":482},"referral_count",{"type":36,"tag":165,"props":484,"children":485},{},[486],{"type":47,"value":381},{"type":36,"tag":165,"props":488,"children":489},{},[490],{"type":47,"value":491},"Number of successful referrals made by this subscriber",{"type":36,"tag":143,"props":493,"children":494},{},[495,504,508],{"type":36,"tag":165,"props":496,"children":497},{},[498],{"type":36,"tag":84,"props":499,"children":501},{"className":500},[],[502],{"type":47,"value":503},"sign_up_token",{"type":36,"tag":165,"props":505,"children":506},{},[507],{"type":47,"value":275},{"type":36,"tag":165,"props":509,"children":510},{},[511],{"type":47,"value":512},"Unique token for this subscriber",{"type":36,"tag":143,"props":514,"children":515},{},[516,525,529],{"type":36,"tag":165,"props":517,"children":518},{},[519],{"type":36,"tag":84,"props":520,"children":522},{"className":521},[],[523],{"type":47,"value":524},"thank_you_url",{"type":36,"tag":165,"props":526,"children":527},{},[528],{"type":47,"value":275},{"type":36,"tag":165,"props":530,"children":531},{},[532],{"type":47,"value":533},"URL to the subscriber's thank you page",{"type":36,"tag":143,"props":535,"children":536},{},[537,546,551],{"type":36,"tag":165,"props":538,"children":539},{},[540],{"type":36,"tag":84,"props":541,"children":543},{"className":542},[],[544],{"type":47,"value":545},"metadata",{"type":36,"tag":165,"props":547,"children":548},{},[549],{"type":47,"value":550},"Object",{"type":36,"tag":165,"props":552,"children":553},{},[554],{"type":47,"value":555},"Custom fields and additional information about the subscriber",{"type":36,"tag":143,"props":557,"children":558},{},[559,568,572],{"type":36,"tag":165,"props":560,"children":561},{},[562],{"type":36,"tag":84,"props":563,"children":565},{"className":564},[],[566],{"type":47,"value":567},"referring_domain",{"type":36,"tag":165,"props":569,"children":570},{},[571],{"type":47,"value":275},{"type":36,"tag":165,"props":573,"children":574},{},[575],{"type":47,"value":576},"Domain that referred the subscriber",{"type":36,"tag":143,"props":578,"children":579},{},[580,589,593],{"type":36,"tag":165,"props":581,"children":582},{},[583],{"type":36,"tag":84,"props":584,"children":586},{"className":585},[],[587],{"type":47,"value":588},"ip_address",{"type":36,"tag":165,"props":590,"children":591},{},[592],{"type":47,"value":275},{"type":36,"tag":165,"props":594,"children":595},{},[596],{"type":47,"value":597},"Subscriber's IP address",{"type":36,"tag":143,"props":599,"children":600},{},[601,610,614],{"type":36,"tag":165,"props":602,"children":603},{},[604],{"type":36,"tag":84,"props":605,"children":607},{"className":606},[],[608],{"type":47,"value":609},"country",{"type":36,"tag":165,"props":611,"children":612},{},[613],{"type":47,"value":275},{"type":36,"tag":165,"props":615,"children":616},{},[617],{"type":47,"value":618},"Subscriber's country based on IP",{"type":36,"tag":143,"props":620,"children":621},{},[622,631,635],{"type":36,"tag":165,"props":623,"children":624},{},[625],{"type":36,"tag":84,"props":626,"children":628},{"className":627},[],[629],{"type":47,"value":630},"city",{"type":36,"tag":165,"props":632,"children":633},{},[634],{"type":47,"value":275},{"type":36,"tag":165,"props":636,"children":637},{},[638],{"type":47,"value":639},"Subscriber's city based on IP",{"type":36,"tag":143,"props":641,"children":642},{},[643,652,656],{"type":36,"tag":165,"props":644,"children":645},{},[646],{"type":36,"tag":84,"props":647,"children":649},{"className":648},[],[650],{"type":47,"value":651},"timezone",{"type":36,"tag":165,"props":653,"children":654},{},[655],{"type":47,"value":275},{"type":36,"tag":165,"props":657,"children":658},{},[659],{"type":47,"value":660},"Subscriber's timezone based on IP",{"type":36,"tag":143,"props":662,"children":663},{},[664,673,677],{"type":36,"tag":165,"props":665,"children":666},{},[667],{"type":36,"tag":84,"props":668,"children":670},{"className":669},[],[671],{"type":47,"value":672},"joined_with",{"type":36,"tag":165,"props":674,"children":675},{},[676],{"type":47,"value":275},{"type":36,"tag":165,"props":678,"children":679},{},[680],{"type":47,"value":681},"How the subscriber was added (api, form, etc.)",{"type":36,"tag":143,"props":683,"children":684},{},[685,694,698],{"type":36,"tag":165,"props":686,"children":687},{},[688],{"type":36,"tag":84,"props":689,"children":691},{"className":690},[],[692],{"type":47,"value":693},"joined_at",{"type":36,"tag":165,"props":695,"children":696},{},[697],{"type":47,"value":381},{"type":36,"tag":165,"props":699,"children":700},{},[701],{"type":47,"value":702},"Timestamp when the subscriber joined (milliseconds since epoch)",{"type":36,"tag":112,"props":704,"children":706},{"id":705},"error-responses",[707],{"type":47,"value":708},"Error Responses",{"type":36,"tag":227,"props":710,"children":712},{"id":711},"not-found-404",[713,715],{"type":47,"value":714},"Not Found ",{"type":36,"tag":84,"props":716,"children":719},{"className":717},[718],"inline-code-red",[720],{"type":47,"value":721},"404",{"type":36,"tag":119,"props":723,"children":726},{"code":724,"language":218,"meta":125,"className":725},"{\n  \"statusCode\": 404,\n  \"error\": \"Not Found\",\n  \"message\": \"Subscriber not found\"\n}\n",[220],[727],{"type":36,"tag":84,"props":728,"children":729},{"__ignoreMap":125},[730],{"type":47,"value":724},{"type":36,"tag":227,"props":732,"children":734},{"id":733},"access-denied-403",[735,737],{"type":47,"value":736},"Access Denied ",{"type":36,"tag":84,"props":738,"children":740},{"className":739},[718],[741],{"type":47,"value":742},"403",{"type":36,"tag":119,"props":744,"children":747},{"code":745,"language":218,"meta":125,"className":746},"{\n  \"statusCode\": 403,\n  \"error\": \"Forbidden\",\n  \"message\": \"Access denied to this subscriber\"\n}\n",[220],[748],{"type":36,"tag":84,"props":749,"children":750},{"__ignoreMap":125},[751],{"type":47,"value":745},{"type":36,"tag":61,"props":753,"children":755},{"id":754},"examples",[756],{"type":47,"value":757},"Examples",{"type":36,"tag":112,"props":759,"children":761},{"id":760},"get-subscriber-by-id",[762],{"type":47,"value":763},"Get Subscriber by ID",{"type":36,"tag":119,"props":765,"children":770},{"code":766,"language":767,"meta":125,"className":768},"curl \"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002Fyour-waitlist-key\u002Fsubscribers\u002FxyzABC123\" \\\n  -H \"X-Api-Key: your-api-key\"\n","bash",[769],"language-bash",[771],{"type":36,"tag":84,"props":772,"children":773},{"__ignoreMap":125},[774],{"type":47,"value":766},{"type":36,"tag":112,"props":776,"children":778},{"id":777},"get-subscriber-by-email",[779],{"type":47,"value":780},"Get Subscriber by Email",{"type":36,"tag":119,"props":782,"children":785},{"code":783,"language":767,"meta":125,"className":784},"curl \"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002Fyour-waitlist-key\u002Fsubscribers\u002Fuser%40example.com\" \\\n  -H \"X-Api-Key: your-api-key\"\n",[769],[786],{"type":36,"tag":84,"props":787,"children":788},{"__ignoreMap":125},[789],{"type":47,"value":783},{"type":36,"tag":61,"props":791,"children":793},{"id":792},"implementation-notes",[794],{"type":47,"value":795},"Implementation Notes",{"type":36,"tag":112,"props":797,"children":799},{"id":798},"using-email-vs-id",[800],{"type":47,"value":801},"Using Email vs ID",{"type":36,"tag":68,"props":803,"children":804},{},[805,815],{"type":36,"tag":72,"props":806,"children":807},{},[808,813],{"type":36,"tag":76,"props":809,"children":810},{},[811],{"type":47,"value":812},"ID Lookup",{"type":47,"value":814},": More efficient when you already know the subscriber's unique ID",{"type":36,"tag":72,"props":816,"children":817},{},[818,823],{"type":36,"tag":76,"props":819,"children":820},{},[821],{"type":47,"value":822},"Email Lookup",{"type":47,"value":824},": More convenient when integrating with systems that track users by email",{"type":36,"tag":37,"props":826,"children":827},{},[828],{"type":47,"value":829},"Note that email lookups are case-insensitive. The email address is normalized to lowercase before lookup.",{"type":36,"tag":112,"props":831,"children":833},{"id":832},"metadata-usage",[834],{"type":47,"value":835},"Metadata Usage",{"type":36,"tag":37,"props":837,"children":838},{},[839,841,846],{"type":47,"value":840},"The ",{"type":36,"tag":84,"props":842,"children":844},{"className":843},[],[845],{"type":47,"value":545},{"type":47,"value":847}," object contains any custom fields you've collected or stored with the subscriber. This can include:",{"type":36,"tag":68,"props":849,"children":850},{},[851,856,861,866],{"type":36,"tag":72,"props":852,"children":853},{},[854],{"type":47,"value":855},"Custom form field values",{"type":36,"tag":72,"props":857,"children":858},{},[859],{"type":47,"value":860},"Integration data from other systems",{"type":36,"tag":72,"props":862,"children":863},{},[864],{"type":47,"value":865},"Tracking parameters",{"type":36,"tag":72,"props":867,"children":868},{},[869],{"type":47,"value":870},"User preferences or characteristics",{"type":36,"tag":61,"props":872,"children":874},{"id":873},"rate-limits",[875],{"type":47,"value":876},"Rate Limits",{"type":36,"tag":37,"props":878,"children":879},{},[880,882,889],{"type":47,"value":881},"See ",{"type":36,"tag":883,"props":884,"children":886},"a",{"href":885},"\u002Fdocs\u002Fapi\u002Frate-limits",[887],{"type":47,"value":888},"API Rate Limits",{"type":47,"value":890}," for more information.",{"title":125,"searchDepth":12,"depth":12,"links":892},[893,895,899,912,916,920],{"id":63,"depth":894,"text":66},2,{"id":107,"depth":894,"text":110,"children":896},[897,898],{"id":114,"depth":12,"text":117},{"id":130,"depth":12,"text":133},{"id":198,"depth":894,"text":201,"children":900},[901,906],{"id":204,"depth":12,"text":902,"children":903},"Success Response 200",[904],{"id":229,"depth":905,"text":232},4,{"id":705,"depth":12,"text":708,"children":907},[908,910],{"id":711,"depth":905,"text":909},"Not Found 404",{"id":733,"depth":905,"text":911},"Access Denied 403",{"id":754,"depth":894,"text":757,"children":913},[914,915],{"id":760,"depth":12,"text":763},{"id":777,"depth":12,"text":780},{"id":792,"depth":894,"text":795,"children":917},[918,919],{"id":798,"depth":12,"text":801},{"id":832,"depth":12,"text":835},{"id":873,"depth":894,"text":876}]