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

# /avvo/lawyers

> Get an Avvo attorney profile by id (e.g. 1625117), profile slug or profile URL: full name, headshot, biography, Avvo Rating with label, client review star average with per-star breakdown and review count, practice areas with focus percentage and years practiced, office contact and geo, state bar licenses with status and acquired year, spoken languages, education, honors, work experience, speaking engagements, publications, sample cases, professional associations, awards, accepted payment methods, consultation offer and legal-answer / endorsement activity counts.

**Price:** 10 credits

**⚠️ Common errors:** 412: Attorney not found (well-formed id with no Avvo profile)



## OpenAPI

````yaml /openapi/legal.json post /api/avvo/lawyers
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/avvo/lawyers:
    post:
      tags:
        - /avvo
      summary: /avvo/lawyers
      description: >-
        Get an Avvo attorney profile by id (e.g. 1625117), profile slug or
        profile URL: full name, headshot, biography, Avvo Rating with label,
        client review star average with per-star breakdown and review count,
        practice areas with focus percentage and years practiced, office contact
        and geo, state bar licenses with status and acquired year, spoken
        languages, education, honors, work experience, speaking engagements,
        publications, sample cases, professional associations, awards, accepted
        payment methods, consultation offer and legal-answer / endorsement
        activity counts.


        **Price:** 10 credits


        **⚠️ Common errors:** 412: Attorney not found (well-formed id with no
        Avvo profile)
      operationId: __api_avvo_lawyers_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AvvoLawyersPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AvvoLawyer'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AvvoLawyersPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        lawyer:
          type: string
          minLength: 1
      type: object
      required:
        - lawyer
    AvvoLawyer:
      properties:
        '@type':
          type: string
          default: AvvoLawyer
        id:
          type: string
        name:
          type: string
        alias:
          anyOf:
            - type: string
            - type: 'null'
        profile_url:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        taglines:
          items:
            type: string
          type: array
          default: []
        avvo_rating:
          anyOf:
            - type: number
            - type: 'null'
        avvo_rating_label:
          anyOf:
            - type: string
            - type: 'null'
        rating:
          anyOf:
            - type: number
            - type: 'null'
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
        ratings_per_star:
          items:
            $ref: '#/components/schemas/AvvoRatingStar'
          type: array
          default: []
        phone:
          anyOf:
            - type: string
            - type: 'null'
        website:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        zip_code:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        practice_areas:
          items:
            $ref: '#/components/schemas/AvvoLawyerPracticeArea'
          type: array
          default: []
        areas_served:
          items:
            type: string
          type: array
          default: []
        languages:
          items:
            type: string
          type: array
          default: []
        licenses:
          items:
            $ref: '#/components/schemas/AvvoLawyerLicense'
          type: array
          default: []
        education:
          items:
            $ref: '#/components/schemas/AvvoLawyerEducation'
          type: array
          default: []
        honors:
          items:
            $ref: '#/components/schemas/AvvoLawyerExperience'
          type: array
          default: []
        work_experience:
          items:
            $ref: '#/components/schemas/AvvoLawyerExperience'
          type: array
          default: []
        speaking_engagements:
          items:
            $ref: '#/components/schemas/AvvoLawyerExperience'
          type: array
          default: []
        publications:
          items:
            $ref: '#/components/schemas/AvvoLawyerExperience'
          type: array
          default: []
        sample_cases:
          items:
            $ref: '#/components/schemas/AvvoLawyerExperience'
          type: array
          default: []
        associations:
          items:
            type: string
          type: array
          default: []
        awards:
          items:
            type: string
          type: array
          default: []
        payment_methods:
          items:
            type: string
          type: array
          default: []
        consultation:
          anyOf:
            - type: string
            - type: 'null'
        answer_count:
          anyOf:
            - type: integer
            - type: 'null'
        endorsement_count:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - id
        - name
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    AvvoRatingStar:
      properties:
        '@type':
          type: string
          default: AvvoRatingStar
        stars:
          type: integer
        count:
          type: integer
        percentage:
          type: number
      type: object
      required:
        - stars
        - count
        - percentage
    AvvoLawyerPracticeArea:
      properties:
        '@type':
          type: string
          default: AvvoLawyerPracticeArea
        name:
          type: string
        percent:
          anyOf:
            - type: integer
            - type: 'null'
        years_practiced:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - name
    AvvoLawyerLicense:
      properties:
        '@type':
          type: string
          default: AvvoLawyerLicense
        state:
          anyOf:
            - type: string
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        acquired_year:
          anyOf:
            - type: string
            - type: 'null'
        years_licensed:
          anyOf:
            - type: integer
            - type: 'null'
        misconduct:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    AvvoLawyerEducation:
      properties:
        '@type':
          type: string
          default: AvvoLawyerEducation
        year:
          anyOf:
            - type: string
            - type: 'null'
        institution:
          anyOf:
            - type: string
            - type: 'null'
        degree:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    AvvoLawyerExperience:
      properties:
        '@type':
          type: string
          default: AvvoLawyerExperience
        period:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        detail:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````