> ## Documentation Index > Fetch the complete documentation index at: https://doc.extole.com/llms.txt > Use this file to discover all available pages before exploring further. # Get public steps for a person > Returns program steps completed by the person identified by `personId` that are visible in public scope. Filter by `campaign_id`, `program_label`, or `step_name` when you need a subset. For the authenticated consumer's own steps use `GET /api/v4/me/steps` instead. ## OpenAPI ````yaml /api-reference/management-expert.json get /v4/persons/{personId}/steps openapi: 3.0.1 info: description: >- Advanced configuration endpoints for Extole platform experts: campaign controllers, typed actions and triggers, advanced component types and facets, source mapping, report post-handlers, pre-handlers, and other expert configuration surfaces not included in the standard Management API. title: Management Expert API version: '1.0' servers: - description: Production url: https://api.extole.io security: - HEADER: [] - QUERY: [] - COOKIE: [] tags: - name: Authentication - name: Campaign Controllers - name: Campaign Controllers Actions - name: Campaign Controllers Triggers - name: Campaign Flow Steps - name: Components - name: Components Grants - name: Components Subscriptions - name: Components Types - name: Content - name: Debug - name: Domains - name: Email - name: Event Prehandlers - name: Events - name: Javascript Core Extensions - name: Persons - name: Profiles - name: Report Schedules - name: Report Types - name: Reporting - name: Security Keys - name: Settings paths: /v4/persons/{personId}/steps: get: tags: - Persons summary: Get public steps for a person description: >- Returns program steps completed by the person identified by `personId` that are visible in public scope. Filter by `campaign_id`, `program_label`, or `step_name` when you need a subset. For the authenticated consumer's own steps use `GET /api/v4/me/steps` instead. operationId: getPublicPersonSteps parameters: - in: path name: personId required: true schema: type: string - in: query name: campaign_id schema: nullable: true type: string - in: query name: program_label schema: nullable: true type: string - in: query name: step_name schema: nullable: true type: string responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/PublicPersonStepResponse' type: array description: Successful response '400': content: application/json: examples: binding_error: $ref: '#/components/examples/binding_error' invalid_json: $ref: '#/components/examples/invalid_json' invalid_length_first_name: $ref: '#/components/examples/invalid_length_first_name' invalid_length_last_name: $ref: '#/components/examples/invalid_length_last_name' invalid_parameter: $ref: '#/components/examples/invalid_parameter' invalid_person_email: $ref: '#/components/examples/invalid_person_email' invalid_person_id: $ref: '#/components/examples/invalid_person_id' invalid_profile_picture_url: $ref: '#/components/examples/invalid_profile_picture_url' missing_request_body: $ref: '#/components/examples/missing_request_body' partner_user_id_already_defined: $ref: '#/components/examples/partner_user_id_already_defined' partner_user_id_invalid_length: $ref: '#/components/examples/partner_user_id_invalid_length' person_email_already_defined: $ref: '#/components/examples/person_email_already_defined' person_not_found: $ref: '#/components/examples/person_not_found' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Bad Request '401': content: application/json: examples: method_unauthorized: $ref: '#/components/examples/method_unauthorized' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unauthorized '403': content: application/json: examples: access_denied: $ref: '#/components/examples/access_denied' expired_access_token: $ref: '#/components/examples/expired_access_token' invalid_access_token: $ref: '#/components/examples/invalid_access_token' jwt_authentication_error: $ref: '#/components/examples/jwt_authentication_error' method_unauthorized: $ref: '#/components/examples/method_unauthorized' missing_access_token: $ref: '#/components/examples/missing_access_token' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Forbidden '415': content: application/json: examples: unsupported_media_type: $ref: '#/components/examples/unsupported_media_type' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Unsupported Media Type '429': content: application/json: examples: too_many_requests: $ref: '#/components/examples/too_many_requests' schema: $ref: '#/components/schemas/RestExceptionResponse' description: Too Many Requests components: schemas: PublicPersonStepResponse: properties: campaign_id: nullable: true type: string data: additionalProperties: type: object type: object event_date: type: string journey_name: nullable: true type: string program_label: nullable: true type: string step_name: type: string required: - campaign_id - data - event_date - journey_name - program_label - step_name type: object RestExceptionResponse: description: Represents the API error response properties: code: description: Specific error code for this error type, documented per endpoint type: string http_status_code: description: >- HTTP status code that was returned with this error, useful if client get response code format: int32 type: integer message: description: User readable English description of the error type: string parameters: additionalProperties: description: >- Attributes related to the error, varies be error code, documented per endpoint type: object description: >- Attributes related to the error, varies be error code, documented per endpoint type: object unique_id: description: >- Unique id associated with this error, useful for discussions with Extole type: string required: - code - http_status_code - message - parameters - unique_id type: object examples: binding_error: summary: binding_error value: code: binding_error http_status_code: 400 message: Argument is not of the expected type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_json: summary: invalid_json value: code: invalid_json http_status_code: 400 message: JSON is invalid parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_length_first_name: summary: invalid_length_first_name value: code: invalid_length_first_name http_status_code: 400 message: First Name length greater than 50 characters parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_length_last_name: summary: invalid_length_last_name value: code: invalid_length_last_name http_status_code: 400 message: Last Name length greater than 50 characters parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_parameter: summary: invalid_parameter value: code: invalid_parameter http_status_code: 400 message: Parameter is invalid. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_person_email: summary: invalid_person_email value: code: invalid_person_email http_status_code: 400 message: Invalid person email parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_person_id: summary: invalid_person_id value: code: invalid_person_id http_status_code: 400 message: Invalid person_id parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_profile_picture_url: summary: invalid_profile_picture_url value: code: invalid_profile_picture_url http_status_code: 400 message: Malformed profile_picture_url parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_request_body: summary: missing_request_body value: code: missing_request_body http_status_code: 400 message: Missing request body parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 partner_user_id_already_defined: summary: partner_user_id_already_defined value: code: partner_user_id_already_defined http_status_code: 400 message: Partner user id already defined parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 partner_user_id_invalid_length: summary: partner_user_id_invalid_length value: code: partner_user_id_invalid_length http_status_code: 400 message: Partner user id length greater than 255 characters parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 person_email_already_defined: summary: person_email_already_defined value: code: person_email_already_defined http_status_code: 400 message: Person email already defined parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 person_not_found: summary: person_not_found value: code: person_not_found http_status_code: 403 message: Person not found parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 method_unauthorized: summary: method_unauthorized value: code: method_unauthorized http_status_code: 401 message: Unauthorized access to this endpoint parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 access_denied: summary: access_denied value: code: access_denied http_status_code: 403 message: >- The access_token provided is not permitted to access the specified resource. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 expired_access_token: summary: expired_access_token value: code: expired_access_token http_status_code: 403 message: The access_token provided with this request has expired. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 invalid_access_token: summary: invalid_access_token value: code: invalid_access_token http_status_code: 403 message: The access_token provided with this request is invalid. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 jwt_authentication_error: summary: jwt_authentication_error value: code: jwt_authentication_error http_status_code: 403 message: The jwt authentication failed. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 missing_access_token: summary: missing_access_token value: code: missing_access_token http_status_code: 403 message: No access_token was provided with this request. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 unsupported_media_type: summary: unsupported_media_type value: code: unsupported_media_type http_status_code: 415 message: Request had an unsupported or no media type parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 too_many_requests: summary: too_many_requests value: code: too_many_requests http_status_code: 429 message: >- The server is unable to process your request at the moment, please retry later. parameters: {} unique_id: 00000000-0000-0000-0000-000000000000 securitySchemes: HEADER: in: header name: Authorization type: apiKey x-bearer-format: bearer QUERY: in: query name: access_token type: apiKey COOKIE: in: cookie name: extole_token type: apiKey ````