> For the complete documentation index, see [llms.txt](https://pool-party-xyz.gitbook.io/pool-party-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pool-party-xyz.gitbook.io/pool-party-docs/core-api/auth.md).

# Auth

Authentication endpoints

## POST /api/v1/auth/nonce

> Generate Nonce

```json
{"openapi":"3.0.0","info":{"title":"Pool Party Core API","version":"1.0"},"tags":[{"name":"Auth","description":"Authentication endpoints"}],"security":[{}],"paths":{"/api/v1/auth/nonce":{"post":{"operationId":"generateNonce","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonceDto"}}}},"responses":{"201":{"description":"Nonce generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonceResponse"}}}},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden."},"408":{"description":"Request timeout."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error"}},"summary":"Generate Nonce","tags":["Auth"]}}},"components":{"schemas":{"NonceDto":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address of the user"}},"required":["wallet"]},"NonceResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/NonceData"}},"required":["data"]},"NonceData":{"type":"object","properties":{"nonce":{"type":"string"}},"required":["nonce"]}}}}
```

## POST /api/v1/auth/sign-in

>

```json
{"openapi":"3.0.0","info":{"title":"Pool Party Core API","version":"1.0"},"tags":[{"name":"Auth","description":"Authentication endpoints"}],"security":[{}],"paths":{"/api/v1/auth/sign-in":{"post":{"operationId":"signIn","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifySignatureDto"}}}},"responses":{"201":{"description":"Access token generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessTokenResponse"}}}},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden."},"408":{"description":"Request timeout."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error"}},"tags":["Auth"]}}},"components":{"schemas":{"VerifySignatureDto":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address of the user"},"signature":{"type":"string","description":"The signature generated by the user`s wallet"},"nonce":{"type":"string","description":"The nonce used to generate the signature"}},"required":["wallet","signature","nonce"]},"AccessTokenResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AccessTokenData"}},"required":["data"]},"AccessTokenData":{"type":"object","properties":{"accessToken":{"type":"string"}},"required":["accessToken"]}}}}
```

## POST /api/v1/auth/refresh

>

```json
{"openapi":"3.0.0","info":{"title":"Pool Party Core API","version":"1.0"},"tags":[{"name":"Auth","description":"Authentication endpoints"}],"security":[{},{"refresh-token":[]}],"components":{"securitySchemes":{},"schemas":{"AccessTokenResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AccessTokenData"}},"required":["data"]},"AccessTokenData":{"type":"object","properties":{"accessToken":{"type":"string"}},"required":["accessToken"]}}},"paths":{"/api/v1/auth/refresh":{"post":{"operationId":"refresh","parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessTokenResponse"}}}},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden."},"408":{"description":"Request timeout."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error"}},"tags":["Auth"]}}}}
```

## POST /api/v1/auth/logout

>

```json
{"openapi":"3.0.0","info":{"title":"Pool Party Core API","version":"1.0"},"tags":[{"name":"Auth","description":"Authentication endpoints"}],"security":[{},{"refresh-token":[]}],"components":{"securitySchemes":{}},"paths":{"/api/v1/auth/logout":{"post":{"operationId":"logout","parameters":[],"responses":{"201":{"description":""},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden."},"408":{"description":"Request timeout."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error"}},"tags":["Auth"]}}}}
```