> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Request to Join

Joins a location using a charger's identity and pincode. This allows users to gain access to a location by proving they have physical access to one of its chargers.

<ParamField body="identity" type="string" required>
  The OCPP identity of a charger belonging to the location. Maximum 255 characters.
</ParamField>

<ParamField body="pincode" type="number" required>
  The pincode of the charger (4–8 digits).
</ParamField>

<ParamField body="team_uuid" type="string" required>
  The UUID of the team to join the location with. The authenticated user must be a member of this team.
</ParamField>

## Response

<ResponseField name="message" type="string">
  A confirmation message indicating the location was joined successfully.
</ResponseField>

<ResponseField name="site_id" type="integer">
  The numeric ID of the location that was joined.
</ResponseField>

<ResponseField name="site_uuid" type="string">
  The UUID of the location that was joined.
</ResponseField>

<ResponseField name="site_name" type="string">
  The name of the location that was joined.
</ResponseField>

<ResponseField name="team_uuid" type="string">
  The UUID of the team that joined the location.
</ResponseField>
