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

# Get Profile by RFC

> Get profile information by RFC

## Overview

Retrieve profile information using the RFC (Registro Federal de Contribuyentes) as a query parameter.

## Query Parameters

<ParamField query="rfc" type="string" required>
  The RFC (Mexican tax ID) of the profile to retrieve. Example: `XAXX010101000`
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique profile identifier (UUID)
</ResponseField>

<ResponseField name="name" type="string">
  Profile name
</ResponseField>

<ResponseField name="email" type="string">
  Email address
</ResponseField>

<ResponseField name="phone_number" type="string">
  Phone number
</ResponseField>

<ResponseField name="tax_id" type="string">
  RFC (Mexican tax ID)
</ResponseField>

<ResponseField name="org_id" type="string">
  Organization ID the profile belongs to
</ResponseField>

<ResponseField name="credits_remaining" type="number">
  Number of invoice credits remaining
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.usatimbre.com/api/timbre/get-profile?rfc=XAXX010101000" \
    -H "Authorization: Bearer tmb_your_api_key_here"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.usatimbre.com/api/timbre/get-profile?rfc=XAXX010101000', {
    headers: {
      'Authorization': 'Bearer tmb_your_api_key_here'
    }
  });
  const profile = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.usatimbre.com/api/timbre/get-profile',
      params={'rfc': 'XAXX010101000'},
      headers={'Authorization': 'Bearer tmb_your_api_key_here'}
  )
  profile = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Juan Pérez",
    "email": "juan@example.com",
    "phone_number": "+525512345678",
    "tax_id": "XAXX010101000",
    "org_id": "org_123456",
    "credits_remaining": 50
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Not Found",
    "message": "Profile not found"
  }
  ```
</ResponseExample>